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PREFACE 


MANUAL OBJECTIVES 

The information in this manual enables the new user of the RSX-11M 
operating system to create a text file, using an editing program, and to 
create and run a simple FORTRAN-IV program from that file. 


INTENDED AUDIENCE 
This manual is for the new RSX-11M user. It assumes that you have 
some computer experience, but no experience with RSX-11M. 


STRUCTURE OF THIS DOCUMENT 
This manual is structured so you can learn RSX-11M concepts and termi- 
nology as you create and run a FORTRAN-IV program called ADD.FTN. 


Chapter 1 explains how to use a terminal on the RSX-11M operating 
system. Chapter 2 discusses program preparation on RSX-11M, including 
use of an editing program, a compiler, and the Task Builder. Chapter 3 
outlines the RSX-11M method of handling files and records. Chapter 4 
discusses two system programs designed for handling files: PIP and the 
Queue Manager. Appendix A outlines the steps involved in the develop- 
ment of ADD.FTN, without the extensive explanation provided in earlier 
chapters. (For more detailed information on programming under 
RSX-11M, see the RSX-/1M/M-PLUS Guide to Program Development. ) 


ASSOCIATED DOCUMENTS 

This manual refers frequently to other RSX-11M documents which are 
described in the RSX-11M Documentation Directory. The directory 
defines the intended audience for the manuals in the RSX-11M set and 
provides a synopsis of each manual’s contents. 


CONVENTIONS USED IN THIS MANUAL 
“print” The term “print” indicates what the computer displays 
at the user’s terminal. 


“type” The term “type” indicates what the user types at the 
terminal keyboard. 


Black ink In illustrations of dialogue between the user and the 
computer, what the computer prints is shown in black 
ink, 

Red ink In illustrations of dialogue between the user and the 


computer, what the user types is shown in red ink. 


Vii 


Preface 


[] 


[144,34] 


RUN 


filename 


Vili 


Square brackets enclose the optional parameters to a 
command. For example: 


>PRINT [/optional switches] 


However, the brackets are not part of the command. 
That is, if you want to use the optional COPIES 
switch with the print command above, you do not 
include the brackets in the command line. You simply 
type: 


SPRINT /COPTES32 FOO.FUN 


A UED specification in a command line is always en- 
closed in brackets when you type it; that is, the brackets 
are required for the UFD syntax. 


Uppercase characters, in lines illustrating command 
formats, indicate material that you must type exactly 
as shown. 


Lowercase characters, in lines illustrating command for- 
mats, indicate variable parameters that you select. 


CHAPTER 1 
USING THE TERMINAL 


This chapter tells you how to use a terminal to communicate with the 
RSX-11M operating system. The operating system, in turn, communi- 
cates with the computer hardware. 


An operating system translates language you can understand into language 
the computer can understand. It also translates messages from the com- 
puter hardware to you. This two-way (interactive) communication pro- 
cess usually takes place through a terminal. 


You can use a variety of terminals with RSX-11M. These fall into two 
general categories: hardcopy terminals that print characters on con- 
tinuous forms of paper, and Cathode Ray Tube (CRT) terminals that 
display characters on a screen. Most CRT terminals do not provide per- 
manent records of the activity on your terminal. Figure 1-1 shows an 
LA36 hardcopy terminal. Figures 1-2 and 1-3 show the VT52 and the 
VT100 CRT terminals. 


Figure 1-1 An LA36 Terminal 
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Figure 1-2 A VT52 Terminal 


Figure 1-3 A VT100 Terminal 
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1.1 USING THE TERMINAL KEYBOARD 

All terminal keyboards have the same basic layout as a typewriter. In 
addition, the keyboard includes special keys that affect various computer 
functions. These keys are not in the same position on all terminals; so 
check the keyboard layout each time you use a terminal that is new to 
you. Figure 1-4 is the keyboard of the LA36 and VT52 terminals. Figure 
1-5 illustrates the keyboard of the VT100 terminal. 
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Figure 1-4 LA36/VT52 Terminal Keyboard 
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Figure 1-5 VT100 Terminal Keyboard 


1.1.1. Terminal Function Keys 

Some of the function keys that appear on terminal keyboards are de- 
scribed in Table 1-1. Check the documentation for the system program 
you are using for specific information on that program’s use of terminal 
function keys. 


1.1.2 Control Characters 

You can enter a control character by pressing the appropriate letter while 
you hold down the CTRL key. The system responds to some control 
characters by displaying the up arrow (~) followed by the letter you 
typed (*U, for example). Some other control characters are not echoed 
on your terminal, depending on the function they perform. 


The control keys listed below are options-selected at system generation, 


Therefore, if they do not work for you as described below, check with 
your system manager to see if they are part of your system. 
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Table 1-1 Special Terminal Keys 


CR or RETURN 


CTRL/n 


Terminates an input line and advances the 
carriage or cursor to the first position on the 
next line, 


Part of numerous 2-key combinations (CTRL 
and a letter key. When you press the CTRL 
key, followed by the appropriate letter, the 
combinations can perform a variety of func- 
tions. Each valid combination is called a 
control character, represented in this man- 
ual by n, where n is a variable letter (see 
Table 1-2). 


RUBOUT or DELETE 


Deletes the last character typed on the cur- 
rent line and, if you press the key repeatedly, 
deletes contiguous characters to the left. 
Most CRT terminals remove each deleted 
character from the screen and move the print- 
ing position back one space. However, a 
hardcopy terminal prints a backslash (\), 
then each character as you delete it, then 
another backslash (\) before it prints the first 
correct character. For example: 


MISTKAE\EAK\AKE 


Advances the printing position to the next 
tab stop. Tab stops occur after every eighth 
character position in the line. In other words, 
the first tab stop is character (column) 9. 


These control keys will not always work as described here when you use 
them with various system programs. For example, some editing programs 
do not read CTRL/Z as an exit. Check the documentation for the system 
program you are using to determine its use of control keys. 


Table 1-2 describes the most commonly used control characters. 
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Table 1-2 Terminal Control Characters 


Character 


CTRL/C 


CTRL/O 


CTRL/S and CTRL/Q 


CTRL/R 


Gains the attention of the Monitor Console 
Routine (MCR), which interprets commands 
to the operating system. In most cases, the 
system responds to CTRL/C by displaying 
the explicit MCR prompt: 


MCR> 


This prompt indicates that the system is ready 
to accept input from your terminal. 


Alternately suppresses and resumes the dis- 
play of output at your terminal. 


For example, if you are running a program 
that generates unwanted output, type 
CTRL/O. The system then temporarily stops 
displaying output until you type CTRL/O 
again to resume output display. (If you do 
not type another CTRL/O, the system will 
discard the entire output and then return the 
default MCR prompt (>) to let you know 
output is finished. 


CTRL/S stops the display of output at your 
terminal until you type CTRL/Q to resume it. 
For example, if you are using a CRT terminal 
that displays output too quickly for you to 
read, type CTRL/S to halt the display. When 
you have read what is on the screen, type 
CTRL/Q to restart the output display. Repeat 
the process until you have read the entire file. 


Performs a carriage return and reprints the 
current line on your terminal, omitting any 
deleted characters, and making the line easier 
to read. Before terminating the line with a 
carriage return, type CTRL/R to ensure that 
you have made the right corrections. For 
example: 


MISTKAE\EAK\AKE*R 
MISTAKE 
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Table 1-2 (Cont.) Terminal Contro! Characters 


CTRL/U Deletes the current line. This allows you to 


retype an entire line when individual correc- 
CTRL/X 


tions would be impractical. Remember that 
CTRL/U must be typed before the carriage 
return in order to delete that line. After the 
carriage return is entered, you must use an 
editing command from an editor to delete 
a line. 


Clears your terminal’s typeahead buffer and 
enables you to type additional characters. The 
typeahead buffer is an RSX-11M feature that 
allows your terminal to save up to 36 charac- 
ters before it processes their commands. A 
“bell character” echoes on your terminal no 
matter what character you type when this 
buffer is full. CTRL/X clears the buffer and 
enables you to resume typing. 


CTRL/Z Exits from many RSX-11M system (and user) 
tasks and returns control of the system to 
MCR. 
Note the difference between the CTRL/O-CTRL/O pair of commands and 
the CTRL/S-CTRL/Q commands: 


® When you type CTRL/O after a previous CTRL/O, output dis- 
play resumes further down in the file than the point at which 
you halted it with the first CTRL/O. 

@ When you type CTRL/Q after a CTRL/S, output display begins 
where it stopped. The total output can still be displayed on 
your terminal. 


1.2 MCR COMMANDS 

The commands that interpret terminal input to control system operations 
are called Monitor Console Routine (MCR) commands. You communicate 
with MCR by entering a command line in the following form: 


commandname parameter(s)/keyword(s) line terminator 
commandname 

Consists of three or more letters, terminated by a space, that uniquely 

identify an MCR function. MCR only reads the first three letters. 


Additional letters merely help you identify the command, (The only 
exception to this 3-character rule is the HELP command. You must 
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type this entire command to distinguish it from the MCR HELLO 
command.) Some examples of MCR commands are given below: 


Command Function 
ABO[RT] Stops a running program 
DMO[UNT] Dismounts a volume 
UFD Creates a User File Directory 


parameter 

Specifies the object of the command function, which is usually a task 
or device. (A task is the basic executable program on an RSX-11M 
system.) One or more blank spaces must separate the parameter from 
the command name, or one parameter from another. For example, 
when you issue the ABORT command, you include the name of 
the running task to be aborted. The following command runs the 
task ADDTWO at 12:25:00 

RUN ADDTWO 12:25:00 
The following command aborts the task ADDTWO: 

ABO ADDTWO 

/keyword 

Modifies either the actual function of the command or a parameter 
of the command. When a keyword modifies a command function, 
you must insert a space between the command name and the key- 
word. For example: 

commandname /keyword [=value] 
When a keyword modifies a parameter of a command, the keyword 
immediately follows the parameter. In addition, some keywords are 
modified by an added numerical argument, shown in the examples as 
value. For example: 

parameter/keyword [=value] 


Spaces are also not required between consecutive keywords: 


parameter/keyword/keyword. . . 
commandname /keyword/keyword. . . 


For example: 


SET /CRTS=TI: 
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This command tells the RSX-11M system that your terminal is a 
CRT. TI: is a pseudo device name that stands for the terminal you 
are using, that is the terminal from which a command was entered. 
In this case, CRT is the keyword that determines the function of 
the SET command. 


line terminator 


Represents either the carriage return <CR> or return key, or the 
altmode or escape key (<ESC>). Because <ESC> has a special 
meaning under certain circumstances, this manual uses <CR> as a 
terminator. Any terminator causes the line to be sent to the com- 
puter or to the task waiting for input. 


Before typing a command, you must ensure that the terminal is in the 
right state to accept commands by: 


e Checking that the terminal’s power is on 

@ Checking that the LOCAL/REMOTE switch is set to REMOTE 

e Consulting installation instructions for additional required 
terminal settings or instructions for using a dial-up line 

e Typing CTRL/C to obtain the explicit MCR prompt (MCR>). 


Both the explicit MCR prompt and the default prompt (>) indicate that 
MCR is ready to accept input from your terminal. If you enter CTRL/C 
when you are using a system program other than MCR, you can issue one 
MCR command. The system executes that command and returns you to 
the task you were in when you entered CTRL/C. Both DIGITAL-supplied 
and user-written tasks can request input by displaying a task prompt at 
a terminal. 


NOTE 
If you are working with a system that does not 
support multiuser protection, you do not need 
to log on and off the terminal. Terminals con- 
nected to a nonmultiuser system are available 
to any user. Therefore, you can ignore the 
material in the remainder of this chapter. 


1.2.1. The HELP Command 

HELP is the only command (besides HELLO, the logging-on command) 
that you can issue from a terminal before you log on the system. Because 
the first three letters of HELP are the same as HELLO; you must enter the 
HELP command in full. When you issue this command, your terminal dis- 
plays text (determined by each installation) that tells you how to log on 
and how to issue further commands. Even if you do not need help initially, 
issue the command at least once so that you know the nature of the infor- 
mation available to you from the system. 
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1.2.2 The HELLO Command 
To begin a session at the terminal, you must issue the MCR HELLO com- 


mand to log on. 
Logging on the system accomplishes several things: 


e It allows the system to make sure that you are an authorized 
user and to record information about your use of the system 

e It grants you the use of the terminal for access to the system 
until you log off 

@ It establishes initial default values for your terminal activities 


The MCR HELLO command prompts for its parameters as follows: 


* HELCLOISCRS 
ACCOUNT OF NAME? stem elk 
or 
last-namwecCRo 
FASSWORTS ragsswordaCk> 


[g,m] 


Commonly called a UIC and consists of two octal numbers that 
identify your account on the system. The first number (g) stands 
for your user group; the second number (m) is your member number 
within the group. The general UIC format consists of the two num- 
bers separated by a comma and enclosed in square brackets [g,m]. 
When you receive your UIC on a multiuser protection system, a 
User File Directory (UFD) with the same number is created for 
you. 


Although you have access to other UFDs on the system, your UIC 
remains the same, no matter which UFD you are working with. 


last-name 


Your last name, which you can enter instead of a UIC. The system 
determines your correct UIC from the name you specify. 


password 


A 1- to 6-character alphanumeric string. The system maintains 
account information, including correct passwords for each UIC and 
last name. You cannot gain access to the system unless you type the 
password corresponding to the UIC or name you have entered. 


The system does not print (echo) on your terminal the characters 
you type in response to the PASSWORD prompt. This ensures that 
your password remains private and that no one can log on using your 
account. 
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If you do not know your UIC or password, contact the system manager or 
whoever controls the use of your system. 


An example of the log-on procedure follows: 


“HELACRS 
ACCOUNT OR NAME SCONKAIACR > 
PASSWORDS LOR 


RSX 11M BL26 MULTIUSER SYSTEM 


GOOD AFTERNOON 
12—JAN@79 14507 LOGGED ON TERMINAL TT32¢ 


LO” JAN@ 79 


SYSTEM WILL BE TOWN TOUAY FROM 13300 TO 
15300 FOR CORRECTIVE MAINTENANCE 


When the system receives the correct password the terminal displays a 
message that includes system identification and the date and time you 
logged on the terminal. Notice the password is not echoed in the example 
above; this is the way your terminal will look when you enter your 
password, The terminal can display additional messages, which usually 
supply information that affects general use of the system. The default . 
MCR prompt (>) on the line after the messages indicates that the mes- 
sages are complete and MCR is ready to accept commands. 


If the following message appears when you try to log on, someone else is 
using the terminal: 


HELL Se QOYTHER USER LOGGET ON 


Either try to log on a different terminal or find the person who logged on 
before you. Do not use the terminal without the other user’s knowledge. 


The Quickest Ways to Log On 

Most users want to type as little as possible when using a terminal; they 
also want the quickest possible response time. This section describes ways 
to shorten the log-on procedure. 


Suppressing System Messages 

The HELLO command allows you to enter a special form of the UIC 
parameter to suppress the display of most of the system messages. (The 
system message file text can be written so that important messages cannot 
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be suppressed.) The normal format for a UIC is [gm]. However, if you do 
not want to see the system messages, replace the comma with a slash (/) 
as follows: 


[g/m] 


HELLO allows four UIC formats: 


g/m 
[g/m] 
g,m 
[gm] 


Hither of the slash formats suppresses all but the most important of the 
system messages. When you log on, brackets around the UIC are optional. 
However, a UIC must always be specified in the format [gm] when it is 
a parameter of any other command. 


Suppressing ACCOUNT OR NAME Prompt 

Another way to shorten the time required to log on is to enter the 
HELLO command and UIC (or last name) on the same line using a slash 
character as a separator: 


L, 2OLZ3LQECR 
SSWORTI “CR 


This command format suppresses the prompt for ACCOUNT OR NAME. 


Automatic Execution of Log-On Command File 

After you log on a terminal, the system automatically assigns the name 
SY: to your system disk and then searches your UFD on SY: for the file 
LOGIN.CMD. If found, the system sends LOGIN.CMD to the indirect 
command processor, which executes all of the commands in LOGIN.CMD. 


This feature is useful when there are specific commands you issue each 
time you log on the system. 


For example, you could use your login command to set your terminal to 
be a CRT and to accept lower case letters. You could also include in the 
file a command to print a text file containing messages to yourself (just 
as the system prints a text file containing messages to all users when you 
log on), When you want to change the messages to yourself, you simply 
edit the text file MYLOGIN.TXT below. In this case, the following 
message is displayed on your terminal after the system messages: 
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+ @LOGIN. CMD 

2SET /LOWER=TT: 
SET /CRT#=TI3 

“PIF TLt=MYLOG. TXT 


10300 MEETING WITH MANAGERS 
11300 RACQUETBALL WITH JACK 
12330 FINANCE COMMITTEE MEETING 
=@EOF > 


1.3 ERROR MESSAGES 

When MCR receives input that it does not recognize or that it knows to be 
incorrect, it displays a message on your terminal. An example is the mes- 
sage that appears if you try to log on a terminal already in use. You will 
receive a different message from MCR if you enter a UIC (or last name) 
or password that the system does not recognize: 


2 HEL ACR 
ACCOUNT: OR NAMES CONRAKECKS 
FASSWORT ACK 


HEL «~~ INVALI0 ACCOUNT 


This attempt to log on was not successful, either because the system did 
not recognize the last name (CONRAK), or because you did not enter 
the correct password. 


The appropriate user response to an error condition depends on the 
message displayed. All messages returned by MCR commands are ex- 
plained in the RSX-11M/M-PLUS MCR Operations Manual. Command 
descriptions in that manual include a list of possible messages that the 
command can generate. The manual also includes an alphabetical list of 
all MCR messages. 


Each message a task prints on your terminal begins with the 3-letter name 
of the associated command or task sending you the message. When you 
encounter an error while running a system task, such as a text editor, 
look for an explanation of the message in the documentation for that 
task. 


CHAPTER 2 
PROGRAM PREPARATION 


Four steps are required to prepare a program to run on RSX-11M: 


1. Create a source file 
Compile or assemble the source file to produce an object 
module 

3. Link the object module to create a task image file 

4. Run the task (using an MCR RUN command) 


Each of the steps involves the manipulation of at least one file, which is 
an owner-named and created area on a mass storage volume (usually a 
disk or tape). 


When you log on a terminal, the system automatically allows you access 
to a disk. This disk is your default system disk on which RSX-11M stores 
all your files unless you specify otherwise. (If your system does not have 
multiuser protection, you have automatic access to a system disk that is 
also accessible to all users.) This chapter assumes you are using your 
default system disk. 


Note that the RSX-11M operating system lets you run programs written 
in a number of computer languages. The MACRO-11 assembly language is 
always included with RSX-11M. Check with your system manager to see 
what other languages are available to you. 


Each language has its own system program (called an assembler or com- 
piler, depending on the language). This system program translates a source 
program into an object module and makes sure that the source program 
follows the language syntax rules. 


Each language compiler or assembler can only translate source files 
written for that language: the FORTRAN-IV program in this book must 
be compiled by a FORTRAN-IV compiler (see specific language documen- 
tation for more information.) 


Although this manual illustrates the creation of a FORTRAN-IV program, 
you follow the same steps to create a MACRO program, a COBOL pro- 
gram, or a program in any other compiled or assembled language. The 
only difference is in the language translator you use. 


2.1 CREATING THE SOURCE FILE (EDI) 

The RSX-11M Line Text Editor (EDI) is a system program you can use to 
create a source file. (You can also use EDI to create other types of files, 
such as text files and data files.) RSX-11M includes two other editing pro- 
grams: the DEC Standard Editor (EDT) and the Source Language Input 
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Program (SLP). EDT is especially useful with a CRT terminal because it 
lets you edit by character as well as by line. SLP is used primarily to 
maintain system programs. (See the RSX-11 Utilities Manual for docu- 
mentation of EDT and SLP, as well as additional information about EDI.) 


This chapter uses a limited number of EDI commands to show you how to 
create and edit the source file for ADD.FTN. 


2.1.1 Using EDI to Create a Source File 
To invoke EDI, issue a call to the editor in the same way that you issue 
an MCR command. (Remember you can always type CTRL/C to get the 
explicit monitor prompt and make sure your command is going to MCR.) 
> EDIACR> 
EDI displays its task prompt: 
ETI 


To create a new file using EDI, specify a file name and a file type in the 
following form: 


EQI>filename.filetyre 
filename 
A 1- to 9-character alphanumeric string. 
filetype 
A 3-letter abbreviation, preceded by a period (.). The abbreviation is 


usually related to the file’s contents. The following are standard file 
types for programming language source files: 


Type Language 

.BAS BASIC 

.CBL COBOL 

FTN FORTRAN 

.F4P FORTRAN-IV-PLUS 
MAC MACRO 


The following example, which is used throughout this chapter, illustrates 
the creation of a FORTRAN IV source file called ADD.FTIN. ADD.FTN 
is an interactive program that prompts you to type two numbers at a 
terminal. The program then adds the two numbers and prints the result on 
your terminal. 
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EDIT SOR 
EDL ADM. ETNSORE 
CREATING NEW FILE 
INFUT 


When EDI receives the name of a new file, it creates an empty file 
with that name and type and displays the two lines shown in the example 
above. EDI prints INPUT to let you know it is ready to accept input from 
your terminal. Anything you type except for control characters becomes 
part of the file called ADD.FTN. You can then type in the source program 
for ADD.FTN. When you terminate each line of input with a carriage 
return <CR>, EDI stores the line in a buffer. When you end the editing 
session, EDI writes the entire buffer to the file ADD.FTN. 


You can use the keyboard facilities described in Section 1.1 to correct 
any mistakes on the current line before you type <CR>. Once a line has 
been terminated and written to the buffer, you must use EDI commands 
to make any changes. 


You can also enter the new file name and file type on the same line as 
the call to EDI. This quicker way to create a file is illustrated below. Note 
the use of the DELETE or RUBOUT key, CTRL/R, and CTRL/U in the 
example: 


SENT ANF TNECR> 

CCREATING NEW FILES 

TINFUT 
TYPE TCR 

1 FORMAT (7 ENTER TWO NUMBERS - MeN%)2CR> 
APPENEPPNCCEPT 29K elk 
ACCEPT Sy Ky Lacks 


2 FORMAT (222N22NTS) 20K 
PRINT CU 
TYPE Se NFLeCk 
3 FORMAT ¢¢ THE SUM IS “TS <CR> 
STOR ACK 
ENDACKS 
mn Oe 
KEXACRS 
CEXIT 


After you terminate the last line of text in the program, type a carriage 
return as the first character in the new line. EDI responds by displaying 
an asterisk (*) prompt. Until now, EDI was in Input Mode, the mode it 
entered to create a new file. Typing a carriage return (CCR>) at the 
beginning of a new line switches EDI to Edit Mode. The asterisk is EDI’s 
prompt for commands. 
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The command EX[IT] instructs EDI to write ADD.FTN to your disk area 
and to return control of your terminal to MCR. 


The KILL command closes both input and output files and deletes the 
output file. It eliminates all traces of the current editing session. 


2.1.2 Editing an Existing File 
To edit an existing file with EDI, enter the same command you used to 
create a new file: 


SELL ADD. FTNECK: 


Because a copy of ADD.FTN now exists on disk, EDI responds differ- 
ently, as follows: 


"EDT AQT. FTNICRS 
£00008 LINES REA TN 
CPAGE 12 

x 


EDI creates a copy of ADD.FTN and enters Edit Mode, indicated by the 
asterisk (*) prompt. The message [00008 LINES READ IN] tells you the 
number of lines EDI has placed in its buffer. The lines in the buffer make 
up the text currently available for editing. The buffer may or may not 
contain the entire input file, depending on the size of the file and the 
buffer. To access text beyond the current buffer, issue a RENEW com- 
mand in Edit Mode. Renew writes the current buffer to the output file 
and refills the buffer with the next block of text. 


An internal line pointer determines the line within the buffer to be edited. 
When EDI reads in a buffer, the line pointer points to the line immedi- 
ately preceding the first line of text. This allows you to insert one or more 
lines at the top. You can subsequently reposition the pointer by searching 
for a particular piece of text or by using commands that reposition the 
pointer. 


Locating and Changing Text 

The EDI commands listed below allow you to find and change text in a 
file. You can abbreviate most EDI commands to one or two letters. In 
the following text, the optional portion of each command is in square 
brackets []. 
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Command Function 
L[OCATE] Locates a string of text in the current buffer 
CLHANGE] Replaces one text string with another 
N[EXT] Advances the line pointer to the next line (EDI 


displays the Edit Mode prompt (*) but does not 
display the line) 


P[RINT] Displays the current line on your terminal 

T[OP] Positions the line pointer at the top of the current 
buffer 

BO[TTOM] Positions the line pointer at the bottom of the 


current buffer 


<CR> Points to and displays on your terminal the next 
line in a file 


An example of an EDI editing session is shown below with text explaining 
what each command does to change or to locate lines in the file and print 


them on the terminal. 


SEQT ATI. FTN CR 


LOOO08 LINES REAM IN 

CPAGE La 

KLOCATE ENTERACR 

1 FORMAT ¢¢ ENTER TWO NUMBERS ~- MeN’) 
x 


The LOCATE command in the example above points to and prints the 
next line in the file (after the current line) containing the word ENTER.) 


XCHANGE/ENTERS TYPE /20R> 
I FORMAT €7 TYPE 
x 


TWO NUMBERS - MyN%) 


The CHANGE command above changes the word ENTER to TYPE. Note 
that the slash characters (/) are used to delimit both the old and the new 
text strings. Any ASCII characters that are not used in either string can be 
used to delimit a string. EDI then prints the corrected line on your 
terminal. 


XNEXTEACKS 
*K 
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The NEXT command points to the next line in the text, but does not 
print it on your terminal. 


xFRINTECRS 
ACCEPT Qe yl. 
x 


The PRINT command above displays the current line on your terminal. 


XLOCATE SUMECKS 
3 FORMAT ¢¢ THE SUM TS “’»I%) 
x 


The LOCATE command points to and prints the next line in the file con- 
taining the word SUM. 


* CHANGE /SUM/RESULT/<CR> 
3 FORMATC’ THE RESULT IS %» TS) 
x 


The CHANGE command above changes the word SUM to RESULT. 


KLOCATE (27S) 20k 
CxXEOBXK 


The LOCATE command searches for a line containing (215). In this case, 
EDI reaches the end of the buffer (EOB) without finding the string (215). 
The EDI line pointer only moves forward through the buffer in response 
to a LOCATE command. It does not search backward through a file. 


¥ TOP CRS 
x 


The TOP command moves the line pointer to the top of the buffer (one 
line before the first line of text). At that point, Edit Mode displays the 
asterisk prompt (*). 


*2CKS 
TYFE 
x 


When you enter a carriage return in response to the asterisk prompt EDI 
prints the next line on your terminal. The carriage return also moves the 
EDI line pointer to the next line. Therefore, it performs the same func- 
tion as the NEXT and PRINT commands. In this example the pointer 
points to the first line in the buffer. 
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KEXTTACRS 
REXIT 


The EXIT command writes the current buffer and the remainder of the 
input file to the output file, closes both input and output files, and exits 
from EDI to MCR. 


Inserting and Deleting Text 
The EDI commands listed below allow you to insert and delete text in 
the file. 


Command Function 

I{NSERT] Inserts one or more new lines of text in a file. 
A[DD] Adds text to an existing line. 

D[ELETE] Deletes the current line. 

<ESC> Points to and prints the previous line. Note, how- 


ever, that <ESC> does not display the line you 
just entered with an Insert command. It moves 
the pointer up one line in the text and displays 


that line. 
R{ETYPE] Replaces the current line of text with a new line. 
LI[ST] Prints on your terminal the lines remaining in the 


buffer, from the current line to the end. After the 
LIST command executes, the line pointer is reset 
to the top of the buffer. 


TYPE n Prints on your terminal the next n lines, but does 
not reset the line pointer. 


An example of an EDI editing session is shown below with text explaining 
what each command does to insert or delete text. 


SEIT ANU. THACK 
RQOOO8 LINES REAT INT 
CE AGH a 

* 


EDI retrieves the latest version of ADD.FTN. Note that if you want to 
edit an earlier version of ADD.FTN, you can include a version number in 
this command. 
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*INSERT@CR® 


Cc THIS FROGRAM ALINS TWO NUMBERS<CR = 
SCRte 

KeESC? 

CKBORK 

SCR 

Cc THIS PROGRAM ALIS TWO NUMEERS 

x 


The EDI INSERT command in the text above switches to EDI Input 
Mode and inserts text immediately before the first line of text already in 
the buffer. The second carriage return takes you back to Edit Mode. The 
<ESC> command from Edit Mode causes EDI to display the line before 
the current line. In this case, the line before the current line is the begin- 
ning of the buffer [*BOB*]. The carriage return moves the pointer to the 
line you just inserted, which is now the first line of the text. 


XLOCATE NUMBERS<CRo 

1 FORMAT (€¢ TYFE TWO NUMBERS ~ MyN 4) 
*A00 'PROMET FOR INFUT< CRE 

TPRINTé ‘CRD 


: 


The LOCATE command finds the line on which a string occurs, the ADD 
(append) command attaches a comment text to the line, and the PRINT 
command displays the revised line. 


*_OCATE RESULTSOR ee 
3 GRMAT (7 THE RESULT IS “+1%) 


Piceeeee 

x 
The DELETE command deletes the current line and moves the pointer to 
the next line. 

KeESC 


TYPE Sy hth 
* 


The <ESC> command causes EDI to point to and print the previous line 
in the buffer on your terminal. 


*INSERTACRE 


FORMAT (7 TYPE TWO NUMBERS ~ MeN PROMPT FOR INFUT 


3 FORMAT ¢° THE SUM TS “sy TS IIISPLAY RESUL TACK: 


“CRS 
x 
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EDI enters insert mode and inserts a new line of text. The second carriage 
return causes EDI to reenter Edit Mode at the current line. 


x TOPE CR 


KCK 

C THIS PROGRAM ANOS TWO NUMBERS 

KRETYPE C AQT DISPLAYS THE SUM OF TWO NUMBERS SCR: 
x 


The TOP command repositions the line pointer to the top of the buffer. 
The carriage return points to and prints the next line, which in this case is 
the first line in the buffer. The RETYPE command replaces the current 
line with the text that follows the command. 


kLISTSOR 


C ANN DISPLAYS THE SUM OF TWO NUMBERS 
TYPE 1 
1 FORMAT ¢7 TYFE TWO NUMBERS ~ MyN4) EPROMET FOR INPUT 
ACCEPT 2eKyl. 
2 FORMAT (215) 
TYPE Sy hh 
3 FORMAT ¢¢ THE SUM IS “sTS) 1 00SPLAY RESULT 
STOrF 
EN 
x 


The LIST command displays the lines from the current line to the end of 
the buffer. 


*EXACR 


When you issue the EXIT command, EDI writes the file to your disk area 
and returns control to MCR. 


2.1.3. Basic EDI Commands 


Table 2-1 summarizes the basic set of EDI commands. These commands 
provide all the functions you need for simple editing. 
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Table 2-1 Basic EDI Commands 


A[DD] string Appends string to the current line. 


BO[TTOM] Moves the line pointer to the bottom 


of the current buffer. 
C[HANGE] /string] /string2/ 


<CR> 


CTRL/Z 


D[ELETE] 
<ESC> 


I[NSERT] string 


Replaces string] with string2 in the 
current line. 


When in Input Mode, <CR> returns 
you to edit mode. 

When in Edit Mode, <CR> prints 
the next line on your terminal and 
moves the line pointer to that line. 


Closes the input and output files and 
terminates the editing session. 


Deletes the current line. 


Points to and prints the previous line. 


Closes the input and output files and 
terminates the editing session. 


Inserts string before the next line or 
enters input mode if string is omitted. 


Closes both input and output files 
and deletes the output file. 


Locates the next line containing the 
object string. The search stops at the 
end of the current buffer. 


L[OCATE] string 


REN[EW] 


Advances the line pointer to the next 
line. 


Prints the current line on your 
terminal. 


Writes the current buffer to the out- 
put file and reads in another buffer 
from the input file. 


Program Preparation 


Table 2-1 (Cont.) Basic EDI Commands 


Replaces the current line with the 
object string. 


Command 


R[ETYPE] string 


Moves the line pointer to the top of 
the buffer. 


T{OP] 


TYPE Prints on your terminal the next 
n lines but does not reset the line 
pointer. 


2.2. COMPILING A FORTRAN-IV SOURCE FILE 

After you have created a FORTRAN-IV source file, in this case ADD.FTN, 
the next step is to compile the program into machine-readable (binary) 
form. This compiled program is called an object module. 


2.2.1 Creating an Object Module 
You begin the compilation process by issuing a call to the FORTRAN-IV 
compiler (in the same way you issued a call to the editor, EDI): 


“FOR ADD. ORJ=AND.F TNS CRE 


This command line tells the FORTRAN-IV compiler to compile the 
source file ADD.FTN to produce an object module called ADD.OBJ. As 
the example shows, you specify from left to right the output file (ADD.- 
OBJ), an equal sign (=), and the input file (ADD.FTN). 


NOTE 
RSX-11M command line specifications follow 
the convention used by many computer lan- 
guages: the output of a process appears to the 
left of the equal (=) sign and the input to the 
process appears to the right. (See Chapter 3 for 
more information on file specifications.) 


The FORTRAN-IV compiler defaults the object file type to .OBJ and the 
source file type to .FTN. This means that if you do not include a file type 
with the file name in a command to the compiler, FORTRAN searches for 
a file with the name you supply and a file type of FTN. If it finds one, it 
uses that file as input. FORTRAN creates a file with a type of .OBJ as 
output if you do not specify an output file type. 
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Most RSX-11M system programs and all language processors use defaults 
in this way. For this reason, you should use the standard file types when- 
ever possible. (Additional standard file types are described in the RSX- 
11M/M-PLUS MCR Operations Manual and are listed in the RSX-11M 
Mini Reference.) 


The default file types in the FORTRAN-IV command line are shown in 
Table 2-2. 


Table 2-2 Default FORTRAN-IV Compiler File Types 


— 


Using the defaults, you can shorten the above command to: 


Default File Type 


Listing File 
Object Module 


>FOR ATE ARTEACK 


By appending switches to the input and/or output file specifications, you 
can make special compilation requests. (See the [AS/RSX-11 FORTRAN 
IV. User’s Guide for a description of the FORTRAN-IV compiler 
switches.) All of the examples in this section assume you are using the 
compiler defaults. 


2.2.2 Creating a Listing File 

In addition to translating a source program to an object module, the 
FORTRAN-IV compiler can also supply a listing file and a storage map for 
the program. To create a listing file you enter the command: 


>FOR Aly ADK-ANTACK 


The second ADD on the output side of the command instructs the com- 
piler to produce a listing file and storage map (called ADD.LST) for the 
source program. The listing file provides information on compiler errors 
and the storage map lists the symbolic names used in the program and 
flags references to symbols that will have to be resolved by the Task 
Builder. 


If the system includes the Queue Manager and spooling to a line printer, 
the FORTRAN-IV compiler automatically puts ADD.LST in the line 
printer queue. You can inhibit this automatic printing with the following 
command line: 


FOR AD ALI/-SF&AnneCk 
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The -SP switch tells the compiler not to spool the listing. 

The compiler also stores a copy of ADD.LST on your system disk. (If 
your system does not include spooling, the compiler only stores the file 
on disk.) 

The FORTRAN compiler can also produce a listing file of your program 
without creating an object file. This feature enables you to find errors in 
your program using the listing file, without generating multiple versions 


of unusable object files. To produce only a listing file, enter a command 
in the following form: 


“ FOR y ATTA CR 
Following this command, ADD.LST is both spooled to the line printer on 
systems with spooling and also stored on your disk area. 
Note that you must enter a comma before the listing file specification in 
the command line; otherwise the compiler interprets ADD as an object 


module instead of a listing file. 


The following command causes a copy of ADD.LST to be displayed at 
your terminal but not printed on the line printer or saved on disk: 


FOR AlN THe AlN CRs 


2.2.3. Requesting a Nonresident FORTRAN-IV Compiler 
In some cases, you may issue the FOR command and receive the message: 


MCR TASK NOT IN SYSTEM 


This means that the FORTRAN compiler is not currently installed on 
your system. To install the compiler, issue the MCR command: 


“RUN $FORACRS 
This command tells the system to install the FORTRAN compiler in 
memory and to activate it at your terminal. The compiler responds with 
the prompt: 

FORT 


You then enter the FORTRAN-IV command as illustrated previously: 


FOR 7 
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After the compiler executes your commands, it displays the task prompt 
(FOR>) once again. At this point, you can compile additional FORTRAN 
programs or exit from the compiler. Enter CTRL/Z to terminate the com- 
piler and remove it from memory. (See the RSX-11M/M-PLUS MCR 
Operations Manual for details on the RUN command.) 


2.3. BUILDING A TASK IMAGE 

The RSX-11M Task Builder converts the object modules created by a 
language translator into a single task image file. This task image file 
resides on disk until someone issues an MCR command to install and run 
it. (You may have used computer systems which referred to some parts of 
the Task Building process as linking or loading.) 


2.3.1 Full Task Build Command Line 
A full Task Builder command line uses three output files and any number 
of input files. The output files are: 


1. The task image file (filename.TSK) which contains the task 
image to be installed and run 

2. A memory allocation file (filename.MAP) which contains infor- 
mation about the size and location of various parts of the task 

3. A symbol definition file (filename.STB) which contains infor- 
mation about the task’s global symbol definitions (The STB 
file is not needed or created in most Task Builder operations.) 


The input files include all of the object modules and modules from system 
or user libraries required to produce a single task image. The full Task 
Builder command line is: 


>TKB task image file, map file, symbol definition file=object file(s) 


Table 2-3 illustrates the default file types in the Task Builder command 
line. 


Table 2-3 Default Task Builder File Types 


Default File Types 


Object File 
Task Image File 
Task Builder Map 
Symbol Definition 
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To Task Build ADD.FTN, issue the following command: 
“TRKB ADD. TSK» ADD. MAF ADD. STRAND. OBJ»e LBS CLs LIFOROTS/LEACR> 


In this command, LB: is a pseudo device name for the device containing 
the library, [1,1] is the UFD where the library is stored, and FOROTS 
is the FORTRAN Object Time System library. The RSX-11M/M-PLUS 
Task Builder Manual describes the use of the LB switch to include OTS 
libraries in task image files. 


Using Task Builder defaults, the command can be shortened to: 
“TRE ADD ADDN AND=AINe LES CL LIFOROTS/LBZCRS 


2.3.2 Short Task Build Command Lines 

Like the compiler, the Task Builder allows you to omit any output file 
or to direct output files to your terminal or to a line printer. However, 
if you omit an output file in the beginning or middle of the output side of 
a file specification, you must retain the comma in place of the file name 
to specify a null (empty) field. On the input side of the command, use a 
comma to separate one input file from another. Table 2-4 illustrates the 
creation of Task Builder output files. 


Table 2-4 Task Builder Output Files 


Command Line Output Files Generated 


All three output files 


Symbol definition file only 


>TKB .TSK,.MAP,.STB=.OBJ 


>TKB ,,.STB=.OBJ 


>TKB ,.MAP,.STB=.OBJ Memory allocation and symbol 


definition files 


>TKB .TSK,,.STB=.OBJ Task image and symbol defini- 


tion file 


>TKB .TSK,MAP=.OBJ 


Task image and memory alloca- 
tion files 


>TKB .TSK=.OBJ 


Task image file only 


2.3.3 Multiline Task Build Command Procedures 

A long list of input files can cause a Task Builder command line to exceed 
the terminal’s maximum line length. If this happens, you can invoke the 
Task Builder in the following manner: 


* TRESCRS 
TKES 
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After you enter the carriage return, MCR activates the Task Builder, 
which then returns the TKB> prompt. The Task Builder displays its 
prompt after each line of input until you enter two slash characters (//) 
and a carriage return at the beginning of a line. The slash characters ter- 
minate operation of the Task Builder and return you to MCR. For 
example, the single command line: 


* TKE 


TKR? filmam. TSK filoam MAP, tilnam. STRef i loam OBS ORI 7 OBI ECRS 


can be entered as: 


TKB> filnam. TSKyfilnam MAP yfilnam. STR fi loam LOR JECR 
TKBY filnam2 OBJrfilnams OBIECRS 
TRE? //2C0K> 


2.3.4 Listing the Memory Allocation (MAP) File 

The memory allocation file (map file) is an ASCII file that contains infor- 
mation about the size and location of components within the task. If your 
system includes the queue manager and print spooling options, the Task 
Builder spools the file to the line printer by default. 


Without the spooling option, however, the Task Builder only stores the 
file on your system disk. 


2.3.5 Task Builder Switches and Options 

The Task Builder includes a variety of switches and options to control the 
creation of a task image on disk. These switches and options are described 
in detail in the RSX-11M/M-PLUS Task Builder Manual. 


2.4 RUNNING A TASK 
To run the task you created, issue an MCR RUN command as follows: 


> RUN ATIC 
The RUN command instructs the system to: 
® Locate ADD.TSK on your default system disk 


e Load a copy of the task image into memory 
e Execute the task 
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When you use this form of the RUN command, the task image file remains 
on disk, ready to be run again, until it is explicitly deleted. 


The following sections illustrate three successful executions of the 
FORTRAN-IV program ADD.TSK. Remember that ADD is an interactive 
program; that is, it prints a message on your terminal and then waits for 
you to type in a response before it performs the calculations and prints 
the result on your terminal. 


SRUN ATIC > 

TYFE TWO NUMBERS - MeN 
79 SLICK 

THE SUM IS 10 

TT47 ~~ STOP 


ro 


“RUN ADVE CK 

TYFE TWO NUMBERS ~ MeN 
wae Gaile 

THE SUM IS 1150 

TTA? ~~ STor 


a 


“RUN ADDACK 

TYPE TWO NUMBERS ~ MeN 
9x1 62C0R> 

THE SUM TS 25 

TT47 ~~ STOF 


Note that when the program completes execution, it displays the line: 
TTA? «= STOR 


TT47 is a temporary name assigned to the task when you issue the RUN 
command. The version of the RUN command used in this example causes 
the system to name the task TTn, where n is the unit number of the ter- 
minal running the program. 


Figure 2-1 reviews the steps to creating the FORTRAN-IV task ADD, 
including the specific files created in each step. 
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>EDI 
EDITOR 


SOURCE 
PROGRAM 


>FOR 


COMPILER 
OBJECT 
MODULE 


>TKB 
TASK 
BUILDER 


TASK IMAGE 


>RUN 


LIBRARIES > 
SYSTEM 
LIBRARIES 


TASK BUILDER 
MAP 


SYMBOL 
DEFINITION 
FILE 


EXECUTING 
TASK 


Figure 2-1 Development of a FORTRAN-IV Task 
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CHAPTER 3 
THE FILES 


The RSX-11M file specification is used by all RSX-11M system programs, 
including editors, compilers, utilities, and the Task Builder. 


The examples in Chapters 1] and 2 emphasized using defaults in command 
line file specifications. Defaults are useful because they allow you to use 
the resources of the system without understanding every possible choice 
available to you. They also permit you to do less typing. In many situa- 
tions, however, you will need a complete file specification, because de- 
faults alone will not cause the system to do what you want it to do. 


The format of a full file specification is: 
dev:[g,m] filename.filety pe; fileversion 
dev: The name of the device that holds the volume on 
which the input file resides (or on which the out- 
put file will reside). 
[g,.m] A User Identification Code (UIC) identifying the 


User File Directory (UFD) that contains (or will 
contain) the file. 


filename The 0-9 character name you supply for the file. 
filetype The 0-3 character type you supply for the file. 
fileversion An octal number that distinguishes between dif- 


ferent versions of the same file. 
Examples of full file specifications are: 


MT1:[116,23] CHARLA.FOO;32 
DM1 :[203,204] FOO.FUM;5 
DK2:[34,63 ] WHO.FOO;3 


Chapter 2 describes the file name and file type fields of a file specification. 
The following sections describe the device name and UFD fields. 


3.1 THE DEVICE NAME 

The device name specifies the volume on which the file resides. The name 
consists of two alphabetic characters and an optional 1- or 2-digit octal 
unit number followed by a colon (:). When the name does not include a 
unit number, the system tries to use unit number 0. 
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Device names in the above examples and their corresponding abbreviations 
are listed below. 


Name Physical Unit 

DkK2: RKO5 disk, unit 2 

DMI: RK0O6 disk, unit 1 

MTI: TUI1O, TEIO, or TSO3 magnetic tape, unit | 


The device name can refer to one of two kinds of devices: 


e An actual physical device, such as the three listed above 
or 


e A pseudo device which can represent a variety of physical units, 
depending upon which terminal enters the unit name 


For example, the name TI: is a pseudo device that refers to the terminal 
from which input is being entered. When you enter input from terminal 
23 on your system, your physical terminal number is TT23: and your 
pseudo terminal is TI:. When you enter input from terminal 6, your 
physical terminal number is still TT6: but your pseudo terminal remains 
TI:. 


Therefore, you can either write a program to send output to TT23:, which 
means you will always have to run the program from TT23:, or you can 
write it to send output to TI:, which means it will always send output to 
whatever terminal installs and runs the task. 


Another pseudo device name is SY:, which corresponds to your default 
system disk. All the files created so far in this manual reside on SY:. 


Section 2.3.1 describes the pseudo device LB:, the volume that contains 
libraries. 


Table 3-1 lists commonly used devices. The letter n stands for the unit 
number of the device. There are different types of disks and magnetic 
tapes, which have correspondingly different device names. Ask some- 
one familiar with your system which names you should use. (See the 
RSX-11M/M-PLUS MCR Operations Manual for a complete list of device 
names.) 
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Table 3-1. Device Names and Abbreviations 


Device Abbreviation 


DECtape 


Disk 


Magnetic Tape 


Terminal 


Pseudo System 
Device 


Because the names SY:, TI:, TT:, and LP: represent input or output 
devices rather than storage media, they usually do not appear in a com- 
plete command line. When you refer to one of these devices in a command 
line, the device name stands alone on one side of the equal sign. For ex- 
ample, the following command sends a copy of ADD.FTN from your 
system disk to your terminal: 


SPP TOS ATO PT NECK 


C AND DISPLAYS THE SUM OF TWO NUMBERS 
TYFE 1 

1 FORMAT (CTYPE TWO NUMBERS «-MyN 7 ETNPOT PROMPT 
ACCEPT 2yW yl. 

2 FORMAT (229) 
TYPE Sy hth. 

3 FORMAT ¢¢ THE SUM TS “9 TS) 'OISPLAY RESULT 
STOF 
ENT 
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3.2 USER FILE DIRECTORIES 

When you log on, you either use your login UIC itself or specify it in- 
directly by using your last name. This UIC identifies the default User File 
Directory (UFD) set up for you on your system disk (SY:) when the sys- 
tem manager made you an authorized user. This UFD is itself a file that 
lists the names of all files stored in your directory. None of the system 
programs can locate a file unless they know the UFD in which the file is 
listed. 


The terms UIC and UFD are often used interchangeably in RSX-11M. The 
UIC, however, identifies the user and the UFD identifies the directory. 


When you need to use files stored in other directories, you can use an 
MCR SET command to change your default UFD (SET /UIC=[g,m]) or 
you can specify a UFC in the file specification. The MCR SET command 


changes the default UFD. However, neither of these actions changes the 
UIC under which you logged on. 


For example, if you want a copy at your terminal of a file from another 
UFD, issue the command: 


SPIP TTEt 2h 302 92007 CONRAD. MAC ACK 


This command assumes that CONRAD.MAC resides on your default sys- 
tem disk, in UFD [302,200]. 


In a system without multiuser protection, your default UFD corresponds 

to the UIC specified in the last SET /UIC command issued from the 

terminal you are using. 

To display the current default UIC on any system, issue the command: 
SSET /UICACK 


When you issue a set command in this form, without specifying what 
UIC is to be set, the system responds with: 


UT Crs ety 
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CHAPTER 4 
PIP AND THE QUEUE MANAGER 


The following sections introduce two utilities, the Peripheral Interchange 
Program (PIP) and the Queue Manager, and show you how to use these 
utilities to copy files, list the files in a directory, delete, rename, and 
purge files, and print files on a line printer or display them on your 
terminal. 


4.1 PERIPHERAL INTERCHANGE PROGRAM 
The Peripheral Interchange Program (PIP) manipulates files on RSX-11M 
by using appropriate switches to perform the operations. 


Among other things, PIP allows you to 


Copy files from one UFD or device to another 
Delete files 

Rename files 

List directories of files 

Purge files 


Any volume you refer to in a file specification must either be allocated as 
public (available to all system users) or be allocated to you (on multiuser 
protection systems only) and mounted. If any volume specified or implied 
in a PIP command is not mounted or is allocated to another user, PIP 
returns the message: 


FIP owe DEVICE NOY MOUNTER/ ALLOCATED 
chad? lety iad 


Device allocation, mounting, and UFD creation are all MCR functions 
accomplished by the following MCR commands: 


e ALLOCATE 
e MOUNT 
e UFD 


(See the RSX-11M/M-PLUS MCR Operations Manual for a description of 
these commands.) In the process of creating, editing, compiling and Task 
Building ADD.FTN, RSX-11M created a number of files on disk: 


e =: The original source file (ADD.FTN;1!) 
@ § Anedited version of the source file (ADD.FTN;2) 
e An object file containing the compiled program (ADD.OBJ;1) 
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A task image file containing linked object code (ADD.TSK;1) 

A memory allocation file (ADD.MAP;1) 

A symbol definition file (ADD.STB;1) 

Additional versions of the above files, if you repeated any of 
the program preparation steps 


All of these files remain on disk taking up space until you explicitly delete 
them. RSX-11M does not automatically eliminate old versions of files. 
(Appendix A includes an example of how consecutive operations can 
create multiple copies of files.) 


You can invoke PIP from MCR in either of two ways: 


1. The single line format, which executes one PIP command and 
returns control to MCR: 


“PIP /LISCRS 


DIRECTORY TBO SOL» 3147) 

L4aWFER<79 O93 10 

AT. FTN GS Le Lig ag 
ALN. TNG 2 me L2eO0 
ALT. F TNS 1 Te Li232 
or 


2. The format that passes control to PIP and allows you to execute 
multiple PIP commands: 


PPT PCR 


PIP? /LISCRS 

DIRECTORY TROL GOL 3144 

L4nFERe 29 O93 10 

ALN. FTNG 3 Ie 11349 
ADIN FTN 2 we bate Ow 
ALTE TNE 1. le L332 


TOTAL OF 4,711. BLOCKS IN 3. FILES 


PIP? ADD.FTN /PUZCR 
Fete “ee 7 


This chapter uses the one-line form shown in number | to illustrate PIP 
command operations. Any command shown here can also be executed in 
the method described in number 2. 
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4.2 PIP COMMAND LINE AND DEFAULTS 

The format of PIP command lines differs for each function. In general, 
however, PIP switches operate on lists of file specifications. PIP uses the 
last value it encounters in a command line as the default value for that 
command. 


You can enter multiple file specifications in a single command line by 
separating the individual file specifications with commas. The switch 
follows the last file specification. 


In the following example, PIP will delete the files named ARRAY.FTN;1, 
MULT.FTN;1 and HEX.FTN:1: 


SRIF ARRAY. FTNS te MULT PING Ly HEX.FTNG A ADE ORD 
The individual file specifications within the list must each meet the 
requirements of the PIP switch involved. Therefore, all of the files being 
deleted in the example must include version numbers because the PIP 


Delete switch requires version numbers. 


Table 4-1 summarizes the PIP switches which are described in this chapter. 
(See the RSX-11 Utilities Manual for additional information on PIP.) 


The following sections describe and illustrate the use of these commands. 
4.2.1 Displaying a File on Your Terminal 


To display a copy of ADD.FTN on your terminal, enter a PIP command 
in the following format: 


SPE TE ANte PTNICRS 
This command produces the following display: 


TYPE 4 


i FORMAT ¢¢% TYPE TWO NUMBERS - MeN’) TPROMPT FOR 


ACCEPT 2yKyl. 
2 FORMAT (21%) 
TYPE Se K+L 


3 FORMAT (¢¢% THE SUM TS ‘“+TS) !0ISFPLAY RESULT 


STOF 
END 
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Table 4-1 PIP Switches and Command Functions 


fae | emee [in 
/LI List Prints the names of requested files con- 
tained in the specified UFD. 

P 
S 


Prints a shortened version of the directory 
generated by the list command. 


Deletes the files specified. 


Purges (deletes all but the highest num- 
bered version(s)) of the files specified. 


Spools (lists on the line printer) all files 
specified. (Note that you can also use the 
Print command of the Queue Manager for 
this function.) 


Rename Renames the input file(s). 


E 
/CO Contiguous Copies the file into contiguous blocks on 
R 


the output volume. 
Truncate 


/SD 


Truncates unused blocks at the end of the 
file. 


Copies the file, using the original creation 
date, instead of updating it to the current 
date. 


Deletes the files specified, after asking you 
whether you want to delete each particular 
file. 


Selective 
Delete 


4.2.2 /LI— Displaying Your User File Directory 
All of the files you create are listed in your UFD. The PIP /LI command 
displays the UFD as follows: 
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PIF /Ltccre © 
DIRECTORY TOs 2109767 
LOWFER-79 14248 

2) 
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° °o 
ANT. OBIF2 ve eae JAN FF Lass 
ATT. TSN G1. L?. C 2O~ JANN FE Lag ae 
ATO. MAF 3 1. 4s (. awe IAN FOF LAGae 
ALN. STRSF 1 .3 Lee AN 79 1033? 
ATI FTN G 1 Le LO-JANN 79 8214 
ANN. TSK 33 a? (" Be JANN 79 L220) 
ANT. ORIG me 2m NECH 7B L306 
ALN. TSKF2 OP» C ePe NEC 278 LasO4 


TOTAL OF 99.7112. BLOCKS IN 8 FILES 


The PIP /LI version of the command includes the following information, 


keyed to the numbers in the directory above: 


@ =‘ The physical volume on which the files are stored, and the UIC 
that owns the directory. The volume named is your default sys- 
tem disk (SY:). The UIC is your default UFD. 


® = The date and time PIP created the directory listing. 


® The name, type, and version number of each file. 


The number of blocks used by each file. A block is 512 bytes 
(256 words) long. 


A file code which indicates the file is either contiguous (C code), 
noncontiguous (no code), or locked (L). Locked files usually 
contain corrupted data. You can access them by using the PIP 
Unlock switch (PIP filename/UN). 


The date and time each file was created. 


The cumulative size in blocks of all the files listed and the num- 
ber of blocks allocated to all the files. 


PIP also provides switches to control the amount of detail given in the 
directory listings. The BR switch causes PIP to generate a directory in 
brief form. For example, the command PIP /BR causes PIP to print a 
directory on your terminal in the form: 
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PIP ARR SCR 
WIRECTORY UBLIC3O39 124 
ALN. EF TNE S 


ANNE TNG 2 
AL. FTN G1 


The FU switch causes PIP to print a directory in more detailed (full) form, 


as shown in the following example: 


PIF /FURCRS 
DIRECTORY MRLICSOSe 124 
21-FER-79 14349 

0 


ALN. FP TNS (1437927) 
3) 


CSO03°127 CRWEN es RWET ye RWETy Ro 


ANI. FING 2 (42069722) 


C3039129 ERWEDs RWEDy RWEDy Ro 


AL. OBI F 1. (2114293) 


CSOSr127 CRWEDy RWET y RWEETy Feo 


2 
TESTB. 20-FER-29 
0 
Qi-FER#79 1420704.) 
ae Sean 20-FEB<79 


QL-FER<79 14322046) 
66+764s 20°F ER 29 
21 FEHR 79 L4te22ca.) 


This form provides the following information (in addition to the informa- 


tion explained in the preceding example): 


@ A file identification number consisting of the file number and 
the file sequence number. This information is used by the 
RSX-11M file system to keep track of your files. 


@ Blocks allocated to each file (in addition to the blocks used). 


by other system users. 


A protection code which tells how your file can be accessed 


@ The date and time the file was last revised and the number of 


revisions. 


After displaying the directory in any of these forms, PIP returns control 


to MCR. 


4.2.3. Display Information on Specific Files 


PIP allows you to obtain information about one file or a specific group of 
files in a directory. For example, if you want to see how many versions of 
ADD.TSK exist in your directory, issue the command: 


PPIP ANN. TSRIX /LICR 
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As the example illustrates, the file specification always precedes the 
switch. 


The command requests PIP to display a directory of all versions of the file 
called ADD.TSK. The asterisk (*) in the version number field tells PIP to 
search for all versions of the file. 


The asterisk (*) character in one or more fields of a file specification 
stands for all. This is also called a wildcard specification. PIP restricts 
the use of wildcards in the cases listed below. 


The following restrictions apply to PIP output file specifications: 


1. Copying a single file 

2. Listing a directory 

3. When you copy several files, the output file specification must 
be *.*;* or default. 

4. The output specification, used with the Rename and Enter 
switches, can mix wildcards with specified fields. With either 
switch, PIP uses the equivalent field of the input field specifica- 
tion. 


In all cases where PIP permits wildcards in the output file specification, 
the wildcard UIC form [*,*] is used to indicate that the output UIC is 
the same as the input UIC. 


The following restrictions apply to wildcards on PIP functions with input 
files: 


1. *.*;* means all versions of all files in the current UFD 
* DAT;* means all versions of all files of file type DAT in the 
current UFD 

3. TEST.*;* means all versions and all types of files with the file 
name of TEST in the current UFD 

4, *.* means the most recent version of all files in the current 
UFD 

5. *.DAT means the most recent version of all files of file type 
.DAT in the current UFD 

6. TEST.* means the most recent version of all file types for files 
named TEST in the current UFD 

7. TEST.DAT means the most recent version of TEST.DAT in 
the current UFD 

8. [*,*] meansall UIC group, member combinations from 1 to 377 

9. [n1,*] means all UIC member numbers under group nl 

10. [*,n2] means all group numbers for member n2 


ADD.*;* refers to all versions of all types of the file named ADD in the 
current UFD. 
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4.2.4 Deleting Files 

Once you know what files are listed in your UFD, you can decide which 
files you want to delete. For example, to retain the highest numbered 
version of each of the files listed in Section 4.2.2, you would delete the 
following files: 


ADD.OBJ;1 
ADD.TSK;1 
ADD.TSK;2 


To delete these files with the PIP Delete switch, issue the following com- 
mand: 


“PIF ADL.ORIJF Ly AND. TSKF Le ANN. TSK FS STEAL CK 


Note that the Delete switch requires either an explicit version number or 
a wildcard in the version field. However, the use of a wildcard is inappro- 
priate when your UFD includes files with the same name but other types 
and versions that you do not want to delete. In this instance, you must 
specify explicitly each file you want to delete. 


4.2.5 Purging Files 

When you want to eliminate all but the highest version of files, the PIP 
Purge switch is often more efficient than the Delete switch. The follow- 
ing Purge command has the same effect as the above Delete command: 


> PIP AQV.k /PULCRS 


Purging does not affect any files in your UFD which only have one ver- 
sion. Note that the file specification for the Purge switch does not include 
a version field. After you issue the above command, you can issue the 
following command to see what files remain in your directory: 


SPIP SLACK 


DIRECTORY YROSCSOLy 314) 
L4nFER@ 79  O9E10 


ADT, ORF 2 me we LAIN? 
ADT. MAFF 1 4s md DAN FP 
ALD. STERFL 3 aed JAN 2 9 
ADM. FING 1 I. 2O~ JAN 29 
ANN. TSK #3 Ps C ee JAN 29 


TOTAL OF 39.749, BLOCKS IN GS FILES 
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As the listing shows, the UFD now contains only the highest version of 
each file. 


4.2.6 Selectively Deleting Files 

The PIP selective delete command prompts for your response before 
deleting a file. The responses allowed (<CR>, *Z,Y,N,Q, and G) cause the 
following action: 


Letter Terminator Operation 
Y <CR> Deletes file and continues 
Y “Z Deletes file and exits from PIP 
N <CR> Saves file and continues 
N “Z Saves file and exits from PIP 
NULL <CR> Saves file and continues 
(no response) 
NULL “Z Saves file and exits 
Q <CR> Saves file and returns to command 
mode. 
°Z Saves file and exits from PIP 
G <CR> Deletes this and all remaining can- 


didates for deletion, lists deleted 
files, and returns to PIP command 
mode. 


G “Z Deletes this and all remaining can- 
didates for deletion, lists deleted 
files, and returns to MCR. 

You can specify the Selective Delete switch (/SD) as follows: 


Poe AY ke SST 


PIP responds: 
NEMETE FUE BLE kSOSyt2I7A0n FP TNGL CYSN/G/ QU? 
NELETE FILE DB1 en S0Sy120A00 OBJFL CY/N/G/00? 
+ 


Y 
N 
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In response to your answers, PIP deletes ADD.FTN;1 but does not delete 
ADD.OBJ;1. 


4.2.7 Copying Files 

Copying files is PIP’s default function; that is, if you enter a legal PIP 
command line with no switches, PIP performs a copy operation. For 
example, the following command copies the file ADD.MAP from your 
UFD on SY: to your UFD on DK:. 


SRIF DK Es ADT. MAPSCR 


The command includes the call to PIP, followed by a file specification in 
the form: 


outfile=infile 
infile 

The file to be copied 
outfile 

The new copy of the file 


When you omit the UFD, file name, file type, and/or version number in 
outfile, PIP defaults the UFD to your default UFD and the name, type, 
and version number of the file to the equivalent fields in the input file. 


Before you can copy a file to a directory on another volume, the directory 
must exist on that volume. In a multiuser protection system, your direc- 
tory on SY: is the only UFD automatically created for you; and in a non- 
multiuser system, no UFDs are automatically created. If the output 
volume specified in the above example does not contain a UFD corre- 
sponding to your UIC, PIP returns the message: 


PIF we CANNOT FUNT DIRECTORY FILE 


horns [ety nl 


4.2.8 Renaming Files 
The PIP Rename (RE) switch allows you to rename existing files. For 
example: 


SPIF ALINTWO Ke KAUN. KIRK SRESOKS 


This command tells PIP to change the names of all types and versions of 
the files named ADD to ADDTWO. Note that you must explicitly specify 
either a number or a wildcard in both input and output version fields 
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when you use the Rename switch. The wildcards in the output file speci- 
fication indicate that the type and version of the renamed files remain the 
same. The directory now contains the following entries: 


DIRECTORY OROSL SOL: 3149 
4-AUG-78 3303 


ALNTWO .OBIF 2 me ade IAN 7ZP 14331. 
ANNTWO «MAP SE 1 a, Qe JAN 2ZP 14s 32 
ALNTWO .STRS 1 Je aun IAN ZF 14334 
ADNTWO .FTNG 1. Ls LO~ IAN 29 TERS 
ATTITWO 6 TSK ES Pe C LOAN 79 O25 45 


TOTAL OF 39.749. BLOCKS IN S&S FILES 


Because the renaming function does not transfer data, you cannot specify 
a different device in the output file specification. If you want to rename a 
file as you copy it to another volume, enter the new name in the output 
specification of the COPY command line. For example: 


SEITE TK TADOTWO oko KEAN KEK 


This command tells PIP to copy all types and versions of the file named 
ADD, which are stored in your UFD on SY:, to an equivalent UFD on 
the DK: disk, unit 0, where they will be named ADDTWO. 


4,3 THE QUEUE MANAGER 

System users often need to have copies of their files printed on the line 
printer. Consequently, the line printer is in heavy demand. An RSX-11M 
task called the Queue Manager provides for orderly use of the line printer. 
It does this by maintaining a queue of files to be printed according to 
their priority, time of request, and other factors, and by displaying infor- 
mation to let you know your file’s place in the queue. 


4.3.1 Printing Files 
To send files to the line printer queue, you use the Queue Manager PRINT 
command, as follows: 


SFRINT ALL. MAP LCRS 


Note that you do not need to specify LP: or any other output file. This 
command asks the Queue Manager to enter ADD.MAP to the queue of 
files waiting. to be printed. The system maintains the queue by file name 
and file identification number, copying each file or group of files to the 
line printer, usually on a first queued, first printed basis. The system also 
allows you to specify that files be printed after a certain time or date. 
Check the RS.X-11 Utilities Manual for more information about the Queue 
Manager. 
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4.3.2 Listing Files in the Queue 
To determine whether a particular file is in the queue, waiting to be 
printed, type the following Queue Manager command: 


QUE /LISTACKR 


The names of all the files waiting to be printed will be displayed on your 
terminal in response to this command in the following format: 


xk PRINT QUEUES kx 
@ FRINT => LFOS 
303% 3071 MP REF (2000 9 3276) ACTIVE ON LOS 
NROTL S03» 4MREP OCs 1 
O (HBOS L SOS» SLOTAL.FTNG 1 
DRA C1LO0s LIANG. FTNG 2 


@ Identifies the file currently being printed, its file identification 
number, name, and the printer. 


@ Names of the files waiting in the queue to be printed. (These are 
listed in the order in which they will be printed.) 
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APPENDIX A 
SAMPLE FORTRAN PROGRAM 


The following listing shows the development of the FORTRAN-IV pro- 
gram, ADD.FTN, and the manipulation of the resulting files. The listing 
illustrates how rapidly you can create numerous versions of the same file, 
and what to do to eliminate the old versions. 


What you type on your terminal is printed in red; what the computer 
prints on your terminal is printed.in black. 


HEL ACR 
ACCOUNT OR NAMES CONRAD CRE 
FASSWORT om Os 


ROX@LIM BL26 MULTL-USER SYSTEM 


GOON MORNING 
L2-JAN@79 19337 LOGGED ON TERMINAL TT32¢ 


L2~ JAN 79 
SYSTEM WILL BE TOWN TOLAY FROM 13300-15200 


PENI AL. F TNC 

CCREATING NEW FILES 

UNF UT 
TYPE Lacks 

il FORMAT ¢€’ ENTER TWO NUMBERS ~ MyN’ SCRE 
APPENEPPACCEPT 29K el ORC: 
ACCEPT 29 Kee Lake 

2 FORMAT (222N\22NTS5) SC 
PRINT “WU 
TYPE Se K+L Ck 

3 FORMAT ¢° THE SUM IS “»TS)<Ck> 
STOP ACR 
END CRS 


Sample Fortran Program 


SE IP TIS Ald. FTN 


TYRE A 
i FORMAT ¢¢ ENTER TWQ NUMBERS ~ My»N%) 
ACCEFT 2yKyk. 
2 FORMAT (20%) 
TYPE Sy K+ 
3 FORMAT ¢/ THE SUM IS ‘%»IS) 
ST Or 
ENY 


“EDT ALI. FTNECRS 
£00008 LINES REAL INI 
CRAG 19 
XLOCATE ENTER CR 
1 FORMAT ¢¢ ENTER TWO NUMBERS ~ MyN%) 
XCHANGE /ENTER/ TYPE /Z Ch 
1 FORMAT ¢¢ TYPE TWO NUMBERS ~ My»N%) 
ANEX TECK 
XPROINT ACK 
ACCEPT 2yWe lL, 
XLOCATE SUMACK: 
3 FORMAT ¢¢ THE SUM T&S *9 Ts) 
XCHANGE /SUM/RESULT/2CK > 
3 FORMAT ¢¢° THE RESULT TS “»Ts) 
KLOCATE C205) 2CR> 
TREO KOK |) 
KTOP ACR 
KALCO 
TYPE 2 
KEXITACR? 
CEXITS 


Sample Fortran Program 


PED Al. FE TNSCR 

(00008 LINES REAM ING 

CFAGE 5 i 

KX INSERT SCR 

C THIS PROGRAM ANS TWO NUMBERSACR: 
LCR 

KL ESC? 

“KBOE XK 

KOK 

C THIS PROGRAM ATS TWO NUMBERS 
XLOCATE NUMBERS SOR 

1 FORMAT €¢° TYPE TWO NUMBERS ~- MyN%) 
XAT TEROMET FOR TNFUT SCR 

XERINT OK: 

1 FORMAT ¢¢° TYPE TWO NUMBERS - My»N%) IPROMET FOR INPT 
XLOCATE RESULTS OR: 

3 FORMAT ¢° THE RESULT IS “9 TS) 
XOELETE SOR 


TYRE Se K+L. 
XINSERT SOR 
3 FORMAT ¢€7 THE SUM IS ‘9 TS) UQISFLAY RESULTACRS 
“ORS : 
XTOP ACR 
KCK 
C THIS FROGRAM AINIS TWO NUMBERS 
XRETYPE C Alu QISPLAYS THE SUM OF TWO NUMBERS <Chi 
KLISTAOR 
C ALY TESPLAYS THE SUM OF TWO NUMBERS 
TYPE 
i FORMAT €¢7 TYPE TWO NUMBERS - MeN EINEUT PROMPT 
ACCEFT Bey. 
a FORMAT (20S) 
TYPE Sel 
x FORMAT ¢¢ THE SUM IS ‘ses TSO IMISFPLAY RESULT 
STOF 
EENY 


“PIP AQ ALT CRS 


HIRECTORY DELICE SOS e120 
Ge MAVe 29 20309 
OG—-MAY 79 20308 


OG MAY 279 20307 
Ob MAY 79  1E3 4? 


ANI. F TNS 3 1 
ADTLFTNG 2 1 
AND. F TNE 1 1 


oo ¢ © 


TOTAL OF 3.4/9. BLOCKS IN 3. FILES 
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“FOR ALIHATINE CK 
«MAIN. 
SRIF AN. KIK /LIACRS 


DIRECTORY DBLICSOSs129 
E- MAY 79 20510 


ANT. FTNG 1 Le 
ADDL FTNG 2 1+ 
ADL. FTNGS 1. 
ANT. OIF 1 me 


TOTAL OF %./20. BLOCKS IN 4. 


“FOR » AL/-SFeALNC OR 
/MAIN, 
PPIP ANN. RSX /LLECRS 


DIRECTORY YERLIE SOS 2 124 
SMA 79  2OR10 


ALT TNG 1 Ie 
ANN. FTNG 2 Le 
ANN. FTNGS 1. 
AND. OBSF 1 me 
AND .LSTH 1 ee 


TOTAL OF 7.47/25. BLOCKS IN 3S. 


“FOR y AIM ANNE CR 
MAING 
PR IF ADT KEK /LISCRS 


QIRECTORY URLIC SOS 9127) 
GMA 79 20310 


AN. F TNE I 
ANNE TNG 2 ] 
ALN F TNE 3 

ALT. OBJ§ 1 
ANN «LST eh : 
ALN LST #2 2 


> 


> 


i 
1 
1 


- + & © & 


TOTAL OF 94/730. BLOCKS IN 4- 


FILES 


PLES 


PYLES 


06—MAY~ 
i$) 4 soe M ay ane 
06—MAY~ 


Ob MAY 
OS—MAY 7 


79 
79 
79 
79 


Ob-MAY~75 


Ob—MAY~ 


79 
79 
79 
79 
79 
79 


LY B4? 
20307 
2OeO8 
2O309 


Lesa? 
LOS O?7 
20208 
ZOLOP 
20340 


LPt4? 
eOFO? 
23003 
LOE? 
SOeL9 


2Oc12 


Sample Fortran Program 


SFOR ADT ANI/-SP2A0n Ck 
+MAINe 
SRIF ADM. KER SL TOR 


DIRECTORY TELS S039 124 
SHMAY 79 20512 


ADL FTNG I Le Ob—MAY-79 L934? 
ANIL F TN G2 1. OG MAYH79 20807 
ALTAR TNS 3 Ie Ob—MAY@ 79 20200 
ALT. ORF 1 me Od MAY 79  2OSOP? 
ADO.LSTHT we OG MAK 79 BOTTA 
AMNLST HA me OG MA 79  2Oe48 
ANN. OBSF 2 ee OSb—MAV 79  2OE18 
ALN + LST ss ne OG—MAY 72  2OFTR 


TOTAL OF 13.740. BLOCKS IN 8. FILES 


*POR ALN y ANN AIIECR > 
oMAIN, 
“PIP ANI. KEK /LTACKS 


QIRECTORY DRI SOSs 120 
Oe MAY 79  2OTLS 


ANT. F TNE TL he OG MAY FP 19S4? 
ALTE TNG 2 Is Qa MAY 29 2OSO? 
ALF TN G3 1s OG MAY 79 2OSO93 
ANN. ORF t ae DG MAL FP BORO? 
AIM LST ed me GMA 29 BORLO 
ALN. LSTHS me OG MAZE 2012 
ALN. OBI 2 we OG—MAY R79 BOE 
ALT. LOT #3 me OG—-MAY 79 2OE1R 
ALN. OW G me OG MAY 29 BOTS 
ALT L ST 94 ee OG"MAY RFE 2OTTS 


TOTAL OF 17./50. BLOCKS IN 10. FILES 
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STRE AQT ANTE CRS 
TRE we ANTAGK- 13 UNDEFINED SYMBOLS SEGMENT Ang 


AQT EMM 

EOL 

COs ‘ 
IFRS 

TF WS 


MOLSMM 
REL S 
STPS 
TVS 


sOT I 
$OTSVA ~ 


SRIF ALT. KIRK SL TACK 


QIRECTORY DRA IE 3039127 on 
GMA 79 20516 


ALI ETNG 4 Le Ob-MAY=79 19347 
ALL ETNG2 1. O6—MAY-79 20207 
ADL. ETNG 3 Le O6"MAY-79 20108 
ALD. ORF 4 9, Ob=MAY79 20309 
ALD. LSTF I "9 , O6"MAY"79 20340 
ADDLSTH2 ") O6=MAY“79 20242 
ALN. ORIG? a Ob=MAY=79 BOEL2 a 
ALN. LSTH3 >, Ob=MAY=79 20812 
ALL. ORIG s OS=MAY<79 20213 
AN LSTH4 “9 Ob=MAY=79 2OS13 
ALL. TSK3 I A C Ob—MAY~69 20314 


TOTAL OF 21.754. BLOCKS IN Tl. FILES ( 
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“TRE ¢ AL -SR# 


FIP ANN. KER ZLTe 


SOR 


QNIRECTORY NRLECSO3 9429 


MAY 79 


AT FTN GT 
ANN. FTNG 2 
ALT F TNE 3 
ANT. ORF 1. 
AIM. LGT $1 
ALL. LST #2 
ATM. OBSG2 
AIM. L ST eS 
ALT. OHI9 3 
ANT. LST 94 
ATM. TSK #1 
AT. MARS 1 
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ALI. .&i oe $ 1 
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AIM. TSK Fd. 
ALN. MAPS 
ALM. MAP ES? 
ANN. STRF 1 
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FILES 
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Sample Fortran Program 
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Sample Fortran Program 


“TRE ALLY ALL y AIM AIMy LB Il Ly LIFOROTS/L ESCH 


SFTP AL. KIX SLTACKS 
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Sr MAY 79  SOTLS 


ALT FTNG 1 Le 

ANIL F TNE 1. 
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ALN. OIF 2 ee 

ADL. LST #3 ae 

ANN. OBIS xe 

AMIN. LOT #4 ee 

ATI. TSN 1 Ae (" 
AL. MAF #1 14, 

AL. MAF G2 14. 

ATI. STHG 1 Ae 

ANT. TOKE 2 5 6 C 
ALM. MAM se 3. 14. 

ALK. STFS Ae 


TOTAL OF 104.7142. BLOCKS IN 217. FILES 


SPIF ALN. K /PULCRS 
2PIF ANT. KIRK SLICK 


DIRECTORY DRLEL3039129 
b-MAY"79 BOLL? 


ATI FTN S 1. 
AN. ORGS ee 
ALM LST #4 we 
AN. TSN ES Bs C 
ALN .MAPS3 14, 
ANN. STEs 2 Ae 


TOTAL OF 34.768. BLOCKS IN 6. FILES 
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Sample Fortran Program 


SPIP ALM. KIR STREOK: 
2 RIF ANT KEK SLICK 


QIRECTORY TAO h S039 124 
S- MAY 79 QOL 


ALI. FP TNS 3 Le OG—-MAY R79 20509 
AN. O88 3 ze OG MAY ZF  2OE13 
ANN. LST #4 ee OG MAL FF ROS LS 
AIK. TSK 2 33s C OG MAR 79 BOLLS 
AT. MAF 3 14, OS MAY 279 2Oe15 
ALK. STRe 2 Ae Ob MAY 2E BOTS 


> 


TOTAL OF 34./56. BLOCKS IN 6. FIXLES 


Note that the last ster reduced the munber of blocks 
gllocated to tne 6 files im the cirectory. 


RUN AQNECRS 

TYPE TWO NUMBERS ~- MeN 
By SOCK 

THE SUM IS 1? 
TTB oe STOP 


2 RUN ANDAR 

TYPE TWO NUMBERS - MyN 
439 S420 

THE SUM IS v? 

TT B23 oe ST Or 


RUN ALIS CR: 

TYFE TWO NUMBERS - MyN 
998» QE CR 

THE SUM IS 1004 

TT3BR2 STOP 
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ADD.FTN, 
creation of, 2-2, 2-3 
editing of, 2-4, 2-8 
Assembly process, 2-1 


Bell character, 1-6 
Blocks, 
allocated, 4-5 
total, 4-5 
used, 4-5 


Cc 


Carriage return < CR >, 1-4, 1-8 
Code, 
binary, 2-1 
machine readable, 2-11 
Communication, 
interactive, 1-1 
system to hardware, 1-1 
terminal to system, 1-1 
Compile, 2-1, 2-11 
Compiler defaults, 
file type, 2-11 
object file, 2-1] 
source file, 2-11 
switches, 2-12 
Compiler, FORTRAN-IV, 2-11 
listing file, 2-12 
omitting output files, 2-13 
storage map, 2-12 
switches, 2-12 
Computer Language, 2-1 
Computer Languages, 2-1 
Assemblers, 2-1 
COBOL, 2-1 
Compilers, 2-1] 
FORTRAN-IV, 1-9 
Syntax, 2-1 


E 


EDI, 2-1 

EDI commands, 
ADD command, 2-7 
BOTTOM command, 2- 
CHANGE command, 2- 
< CR> command, 2-5, 2-6 
DELETE command, 2-7, 2-8 
< ESC > command, 2-7, 2-8 
EXIT command, 2-4, 2-7, 2-9 
INPUT command, 2-3 
INSERT command, 2-7, 2-8, 2-9 


“ 
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EDI commands (Cont.) 
KILL command, 2-4 
LIST command, 2-7, 2-9 
LOCATE command, 2-5, 2-6, 2-8 
NEXT command, 2-5, 2- 
PRINT command, 2-5, 2- 
RETYPE command, 2- 
TOP command, 2-5, 2- 
TYPE command, 2-7 
EDT, and CRT terminals, 2-2 
Error message formats, 1-12 
Escape < ESC >, 1-8 


F 

File, 2-1 
File specification, 

compiler input, 2-12 

compiler output, 2-12 

device, 3-1] 

file name, 3-1, 4-11 

file type, 3-1 

file version, 3-1, 4-11 

RSX-11M, 3-1 

Task Builder input defaults, 2-15 

UFD, 3-1 

UIC, 3-1 

Task Builder output defaults, 2-15 
File type, 

BAS, 2-2 

CBL, 2-2 

F4P, 2-2 

FTN, 2-2 

MAC, 2-2 

standard, 2-12 
File, 

contiguous, 4-5 

creation of, 4-] 

explicit deletion of, 4-1 

locked, 4-5 

noncontiguous, 4-5 

other directories and, 3-4 
FORTRAN-IV compiler, 2-11 

command line specification, 2-11 

defaults, 2-11 

Object Time System Library, 2-15 
Function keys, use of, 1-3, 1-4 


Interactive program, 2-2, 2-17 


L 


Language translator, 2-1 
LB:, 2-15 


Line Printer, 
priority, 4-11 
timing, 4-11 
Line Text Editor (EDD, 
Creating new file, 2-2 
Editing existing file, 2-4 
Edit Mode, 2-4 
File version numbers, 2-7 
File names, 2-2 
File specifier, 2-2 
File type, 2-2 
Input Mode, 2-3 
Invoking, 2-2 
Linking, 2-1, 2-14 
Listing file, 
displayed on terminal, 2-13 
without object file, 2-13 
Loading, 2-14 
Logging on system, 1-10 
other user on system, 1-10 
short form, 1-10 
suppressing messages, 1-10, 1-11 
system messages, 1-10 
LP:, 3-3 


Monitor Console Routine (MCR), 1-5, 1-6 
command line, 1-6, 1-7 
default prompt, 1-8, 1-10 
error messages, 1-12 
explicit prompt, 1-6, 1 
implicit prompt, 1-5, 1 
keyword, 1-7 
parameter, 1-7 
terminator, 1-7 
MCR ABORT command, 1-7 
MCR ALLOCATE command, 4-1 
MCR DISMOUNT command, 1-7 
MCR HELLO command, 1-7, 1-8 
MCR HELP command, 1-6, 1-8 
MCR MOUNT command, 4-1 
MCR RUN command, 2-13, 2-16 
executing task, 2-16 
loading task image, 2-16 
locating task, 2-16 
MCR SET command, 2-1, 3-4 
MCR UFD command, 1-7, 4-1 
Multiuser protection system, 1-8, 3-4 
logging on, 1-8 


N 


Nonmultiuser protection system, 1-8 
Nonresident compiler, 

installation of, 2-13 

removal of, 2-14 


8 
-8 


, 1-9, 1-10 
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Object module, 2-1, 2-14 
creation of, 2-11 
Operating System, 
communicating with hardware, 1-1 


function of, 1-1 
MCR and, 1-5 


Pp 

Password, 1-9 
acquiring, 1-10 
echo, 1-9 

Physical device, 3-2 

Peripheral Interchange Program (PIP), 4-1 
blocks allocated, 4-6 
command line defaults, 4-3 
file identification numbers and, 4-6 
file protection code, 4-6 
invocation of, 4-2 
multiple line format, 4-2, 4-3 
revision date, 4-6 
single line format, 4-2 
switches, 4-1 
wildcard restrictions, 4-7 

PIP functions, 
copying files, 4-1, 4-20 
deleting files, 4-8 
displaying brief UFDs, 4-5 
displaying files, 4-3 
displaying full UFDs, 4-6 
displaying UFDs, 4-4 
purging files, 4-8 
renaming files, 4-10 
selectively deleting files, 4-8 

Pseudo devices, 2-15, 3-2 


Q 


Queue Managers, 2-12 

Queue Manager, 4-1, 4-11, 4-12 
listing command, 4-12 
Print command, 4-11 


R 


Return < RET >, 1-4 
RSX-11M Tasks, exit from, 1-6 
RSX-11M Utilities, 4-1 
Rubout, 1-4 


S 


SLP, 2-1, 2-2 

Source file, 2-1 

Source File, Creating, 2-1 
Languages, 2-1 

Source Language Input Program, 2-1 


Spooling, 

automatic of listing file, 2-12 
SY:, 3-2, 3-3 
Symbols, resolution of, 2-12 
System disk (SY:), 3-4 

default, 3-2 

files stored on, 2-13 

multiuser protection, 2-13 

nonmultiuser protection, 2-13 
System message file, 1-10 
System message file, required messages, 1-10 


T 
Tab, 1-4 
Task Builder, 2-14 
full command format, 2-14 
global symbol definitions, 2-14 
LB switch, 2-15 
MAP file type, 2-12, 2-16 
multiline command format, 2-15 
OBJ file type, 2-14 
omitting input files, 2-15 
omitting output files, 2-15 
output files, 
memory allocation file, 2-13 
symbol definition file, 2-13 
task image file, 2-13 
oversize command line, 2-15 
resolution of symbols, 2-12 
short command format, 2-15 
STB file type, 2-12 
switches and options, 2-16 
TSK file type, 2-12 
Task image file, 2-1, 2-14 
Task prompt, 
DIGITAL supplied software, 1-8 
uset-written software, 1-8 
Terminal, 
CTRL/O, continues output, 1-5 
CTRL/Q, suppresses output, 1-5 
CTRL/O, suppresses output, 1-5, 1-6 
CTRL/S, continues output, 1-5, 1-6 
Cathode Ray Tube (CRT), 1-1 
control keys, 1-3 
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Terminal (Cont.) 
function keys, 1-3 
hardcopy, 1-1 
initial default values, 1-9 
input from, 1-6 
keyboard, 1-3 
LA36, 1-1 
local/remote switch, 1-8 
state of, 1-8 
suppressing output, 1-5 
system access through, 1-9 
using the, 1-1 
VT100, 1-2 
VT100 keyboard, 1-3 
VT52, 1-2 
VT52 keyboard, 1-3 
Text file, 2-1 
TI:, 1-8, 3-3 
Typeahead buffer, 1-6 


U 


UFD, 

changing, 3-4 

default, 3-4, 4-19 

nonmultiuser protection, 3-4 
UIC, 1-9, 3-4 

display of, 3-4 

login, 3-4 

special log-on formats, 1-10, 1-11 
UIC/UFD, difference between, 3-4 
User File Directory (UFD), 1-9, 3-4 
User Identification Code (UIC), 1-9, 3-4 

command formats, 1-11 

slash formats, 1-11 
User Logon Text File, 1-10 


V 


Volume, 2-1 
Volume unit number, 3-1 


W 


Wildcard, 4-7 
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INTRODUCTION 


This manual is a brief index to the RSX-11M documentation set. It indicates where in the set informa- 
tion on a general topic can be found. A more detailed master index is being published as a post-release 
document. Neither index, however, is intended to replace the indexes found in the individual RSX- 
11M manuals. 


An acronym printed in italic capital letters follows each entry in this index, and represents the name of 
the manual in which the information can be found. Chapter and section number references follow the 
acronym, Some entries are followed only by the chapter number(s), for example: 


PIP (Peripheral Interchange Program), UTL 4 

This entry indicates that PIP is discussed throughout chapter 4 of the utilities manual. 
Following is a list of the acronyms with the corresponding manual titles, (The RSX-11M/RSX-11S 
Documentation Directory lists the order numbers for these manuals.) 

BEG — RSX-11M Beginner’s Guide 

CDA — RSX-11M/M-PLUS Crash Dump Analyzer Reference Manual 

DEV — RSX-11M/M-PLUS Guide to Program Development 

DRV — RSX-11M/M-PLUS I/O Drivers Reference Manual 

ERL — RSX-11M/M-PLUS Error Logging Reference Manual 

EXE — RSX-11M/M-PLUS Executive Reference Manual 

GEN — RSX-11M System Generation and Management Guide 

INT — Introduction to RSX-11M 

IOP — IAS/RSX-11 I/O Operations Reference Manual 

MAC — IAS/RSX-11 MACRO-11 Reference Manual 

MCR — RSX-11M/M-PLUS MCR Operations Reference Manual 

ODT — IAS/RSX-11 ODT Reference Manual 

SLR — IAS/RSX-11 System Library Routines Reference Manual 

TKB — RSX-11M/M-PLUS Task Builder Manual 

UMD — RSX-11M/M-PLUS User Mode Diagnostics Reference Manual 

UTL — RSX-11 Utilities Manual 

WRT — RSX-11M Guide to Writing an I/O Driver 
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Absolute addressing mode, MAC 5.10 
Accessing files, JOP 1.1, 2.5 
Account file (ACNT) entries, 
maintaining, MCR 2.3 
Account file maintenance program, see ACNT 
ACNT (account file maintenance program), 
MCR 2.3 
Addressing, 
branch instruction, 
in MACRO-11, MAC 5.14 
in supervisor mode, EXE 3.2 
locations in a task image file, UTL 19.3 
modes, 
MACRO-11, MAC 5 
absolute, MAC 5.10 
autodecrement, MAC 5.5 
autodecrement deferred, MAC 5.6 
autoincrement, MAC 5.3 
autoincrement deferred, MAC 5.4 
immediate, MAC 5.9 
index, MAC 5.7 
index deferred, MAC 5.8 
register, MAC 5.1 
register deferred, MAC 5.2 
relative, MAC 5.11 
relative deferred, MAC 5.12 
Address mapping, EXE 3.1 
Address space, 
logical, EXE 3.1 
extended, INT 3.3 
virtual, EXE 3.1 
Analog-to-digital converter driver, DRV 14 
ANSI magnetic tapes, [OP G 
Appending files, UTL 4.2 
Assembler, see MACRO-11 
Assembly language, see MACRO-11 
AST (Asynchronous System Trap), DRV 1.5, 
EXE 2.3, INT 3.3 
service routine, JOP 2.8 
Asterisk, 
convention in MCR, see Wildcards 
EDT prompt, UTL 2.1 
Asynchronous System Trap, see AST 
AT. (MCR indirect file processor), INT 4.1, 
MCR 5.2, 5.6 
Audit trail, 
SLP, UTL 17, 17.4 
Autodecrement addressing mode, MAC 5.5 


Autodecrement deferred addressing mode, 
MAC 5.6 

Autoincrement addressing mode, MAC 5.3 

Autoincrement deferred addressing mode, 
MAC 5.4 


B 


Back-up and Restore Utility, see BRU 
BAD (Bad Block Locator Utility), UTL 9 
Bad Block Locator Utility, see BAD 
Bad blocks, 
information on, 
with DSC, UTE 11.5 
locating, UTL 9.4 
BASIC-11, INT 5.2 
BASIC-PLUS-2, INT 5.2 
Block I/O operations, JOP 1.4 
BRU (Back-Up and Restore Utility), UTL 10 
using, 
for data transfers, UTL 10.4 
to initialize disks, UTL 10.4 
with BAD, UTL 10.4 
with FMT, UTL 10.4 
Buffers, 
EDT text, UTL 2 
BYE command, MCR 2.3, 4.5 


C 


Card reader driver, DRV 11 
Cassette driver, DRV 9 
CDA (Crash Dump Analyzer), 
analysis with, CDA 3.1, 3.2 
obtaining crash dumps with, CDA 1.2 
running, CDA 1.3 
Checkpointing, INT 3.2 
Checksum switch, UTL 17.1, 18.2 
CLI (Command Line Interpreter), 
command-line processing, [OP 6.2 
component of Queue Manager, UTL 7 
CMP (File Compare Program), UTL 16 
COBOL, INT 5.2 
Codes, 
directive, DRV B.2 
I/O status, DRV B.1 
return, DRV 1.10 
Command line, 
BAD, UTL 9.1 
BRU, UTL 10.3 
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Command line (Cont.), 


CDA, CDA 1.4 
CMP, UTL 16 
DMP, UTL 15.2 
DSC, UTL 11.4 
EDI, UTL 3.1 
EDT, UTL 2.1, 2.2 
FLX, UTL 5.1 
FMT, UTL 8.1 
format for utilities, UTL 1.1 
LBR, UTL 14.2 
MCR, 
examples of file name, MCR 3.2 
standard format for, MCR 3.2 
PAT, UTL 18.1 
PIP, UTL 4,1 
PRESRV, UTL 12.1 
PRI, UTL 6.1, 6.2 
Queue Manager, UTL 6.4, 7.3 
SLP, UTL 17.1 
TKB, TKB 1.1 
VFY, UTL 13.2 
ZAP, UTL 19.4 
Command Line Interpreter, see CLI 
Command-line processing, 
CSI—command string interpreter, JOP 6.2 
GCML-—get command line, JOP 6.1 
Commands, 
for utilities, 
summary of, UTL A 
MCR, see MCR commands 
Comparing files, UTL 16 
Compiler, 
FORTRAN IV, BEG 2.2 
Console output task, see COT 
Copying files, BEG 4.2 
DOS-11, UTL 5.2 
Files-11, UTL 4.2, 5.2 
RT-11, UTL 5.2 
CORAL-66, INT 5.2 
COT (Console Output Task), GEN C 
Crash Dump Analyzer, see CDA 
Crash dumps, 
analyzing, CDA 3.1, 3.2 
obtaining, CDA 1.2 


Creating source files, BEG 2.1 
editors for, UTL 2, 3, 17.3 
Creating UFDs, UTL 4.2 
CRF (Cross-Reference Processor), UTL D 
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Data conversion routines, SLR 4, 5 
Data formats, 
TKB input, TKB A 
Data structures, 
for 1/0, WRT 2.3, 2.7 
for I/O drivers, WRT 4.1 
RDB (Region Definition Block), EXE 3.5 
TKB, TKB 2.3, 4.3 
WDB, (Window Definition Block), EXE 3.5 
Data transfers, 
with BRU, UTL 10.4 
with DSC, UTL 11.8 
with FLX, UTL 5 
with PIP, UTL 4.2 


DCB (Device Control Block), WRT 2.3, 4.1 
Debugging, 

on-line, ODT 1.2 

tasks, INT 5.5 

user-written I/O drivers, WRT 3.4 
DEC Standard Editor, see EDT 
DECtape, 

driver, DRV 6 

powerfail recovery for, DRV 1.11 
DECtape II driver, DRV 7 
Deleting files, BEG 4.2 

on system, UTL 4.2 

on volumes, UTL 5.2 
Despooling files, UTL 6.1, C 
Device (see also Devices), 

drive modification, ERL D 

error reports, ERL 4,2 

independence, INT 6.3 

null, MCR 2.2 
Device Control Block, see DCB 
Device interrupt vector, 

for I/O drivers, WRT 2.3, 4.1 
Devices (see also Device), 

file-structured, JOP 1.2 

independence of, INT 6.3 

logical, MCR 2.2 

peripheral, MCR 2.2 

physical, names for, DRV 1.7 

private, INT 4.3, MCR 2.3 

pseudo, MCR 2.2 

names for, DRV 1.7 

public, INT 4.3, MCR 2.3 

RSX-11M, DRV 1.3 

unowned, MCR 2.3 

verifying, UTL 9.3 
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Diagnostics, 
user-mode, 
error messages, UMD 2.5 
for disk drive compatibility, UMD 13 
for line printers, UMD 12 
for RF11 fixed-head disks, UMD 4 
for RKO5 cartridge disk and RKO5F fixed 
disk, UMD 5 
for RKO6 and RKO7 cartridge disk, UMD 6 
for RP02, RPRO2, RP03, UMD 7 
for RP04, RPO5, RPO6 pack disks, UMD 3 
for RS03 or RS04 fixed-head disk, UMD 8 
for terminals, UMD 12 
for TU10 or TS03 magnetic tape, UMD 11 
for TU16 or TU45 magnetic tape, UMD 10 
for TU56 DECtape, UMD 9 
initiation of, UMD 2.4 
multidevice testing, UMD 2.6 
Directive Parameter Block, see DPB 
Directive codes, DRV B.2 
Directives, 
event-associated, EXE 6.1 
functions of system, INT 3.3 
identification codes for, EXE C 
informational, EXE 6.1 
intertask communications-related, EXE 6.1 
1/O-related, EXE 6.1 
macro, MAC 7 
MACRO-11, MAC 6 
MCR AT., MCR 5.2, 5.6 
memory management, EXE 3, 6.1 
parent/offspring tasking, EXE 6.1 
summary of, EXE A 
system, 
DIR$ macro, EXE 1.4 
error returns, EXE 1.3 
FORTRAN subroutines, EXE 1.5 
macro name conventions for, EXE 1.4 
processing of, EXE 1.2 
restrictions for nonprivileged tasks, 
EXE 1.7 
task states, EXE 1.6 
task execution control, EXE 6.1 
task status control, EXE 6.1 
trap-associated, EXE 6.1 
Disks, 
backing up, with BRU, UTL 10.4 
drivers for, DRV 5 
powerfail recovery for, DRV 1.11 
Disk Save and Compress Program, see DSC 
Disk Volume Formatter, see FMT 
Displaying files, BEG 4.2 
DMP (File Dump Utility), UTL 15 


DPB (Directive Parameter Block), DRV 1.6 


and I/O drivers, WRT 4.1 


Drivers, 


Index-4 


analog-to-digital converter, DRV 14 
card reader, DRV 11 
cassette, DRV 9 
DECtape, DRV 6 
DECtape II, DRV 7 
disk, DRV 5 
graphics display, DRV 20 
industrial control subsystems, DRV 18 
1/0, 
executive services available to, 
conditional routines, WRT 5.2 
service calls, WRT 5.3 
system-state register convention, 
WRT 5.1 
function of, WRT 1.2 
loadable, WRT 1.1 
resident, WRT 1.1 
user-written, 
debugging, WRT 3.4 
inclusion of, 
data base and driver source in, 
WRT 6.2 
device description in, WRT 6.1 
special user buffers in, WRT 6.3 
loadable, WRT 3.3 
overview of, WRT 3.1 
rebuilding, WRT 3.4 
resident, WRT 3.2 
writing, 
data structures in, WRT 4.1 
INTSV$ macro and, WRT 4.2 
multicontroller drivers, WRT 4.2 
K-series peripheral support routines, DR V 22 
laboratory peripheral accelerator, DRV 21 
laboratory peripheral systems, DRV 16 
line printer, DRV 10 
magnetic tape, DRV 8 
message-oriented communication, DRV 12 
null device, DRV 19 
paper tape reader/punch, DRV 17 


PCL11 parallel communications link, 
DRV 18 
terminal, 
full-duplex, DRV 2 
half-duplex, DRV 3 
virtual, DRV 4 
unibus switch, DRV 23 


universal digital controller, DRV 15 


INDEX 


DSC (Disk Save and Compress Program), 
initiating, 

on-line, UTL 11.2 

stand-alone, UTL 11.3 


Error Logging (Cont.), 
messages, ERL 5.1 
operating procedures, ERL 3 
options, ERL 1.2 


operation, purposes of, ERL 1.2 
data transfers, UTL 11.8 reports, 
terminating, device error, ERL 4.2 
on-line, UTL 11.2 device interrupt timeout, ERL 4.2 
stand-alone, UTL 11.3 formatting, ERL 1.2 
Dumps, generating, ERL 1.2, 4.1 
file, with DMP, UTL 15 individual, ERL 4.2 
system crash, memory parity error, ERL 4.2 
analyzing, with CDA, CDA 3.1, 3.2 summary, ERL 4.4 
obtaining, with CDA, CDA 1.2 unexpected trap or interrupts, ERL 4.2 
task, task interaction with, ERL 2.2 
post mortem, INT 5.5, TKB 8.1 Error messages, 
snapshot, INT 5.5, TKB 8.2 BAD, UTL 9.7 
BRU processing of, UTL 10.6 
E CDA, CDA A 
CMP, UTL 16.3 
EDI (Line Text Editor), BEG 2.1, INT 5.1, DMP, UTL 15.4 
UTL 3 DSC, UTL 11.9 
Editing files, BEG 2.1 EDI, UTL 3.6 
with EDI, UTL 3 EDT, UTL 2.6 
with EDT, UTL 2 error logging, ERL 5.1 
with SLP, UTL 17 FLX, UTL 5.6 
EDT (DEC Standard Editor), UTL 2 FMT, UTL 8.5 
Editors, LBR, UTL 14.9 
batch, MCR, BEG 1.3, MCR A 
SLP, UTL 17 ODT, ODT 5.1, 5.2 
interactive, PAT, UTL 18.3 
EDI, INT 5.1, UTL 3 PIP, UTL 4.3 
EDT, INT 5.1, UTL 2 PRESRV, UTL 12.5 
ERF (error logging shutdown task), ERL 3.4 PRI and QUE, UTL 6.6 
ERL (error logger task), ERL A.1 Queue Manager, UTL 7.4 
Errlog (error logger), HRL 2.2, 3.1 SLP, UTL 17.5 
Error codes, executive, EXE B TKB, TKB F 
Error detection, TKTN, MCR A 
by ODT, ODT 5.1, 5.2 UMD, UMD 2.5 
Error logging, INT 4.4 ZAP, UTL 19.7 ; 
ERF (shutdown task), ERL 3.4, 5.4 Error reports, see Error logging, reports 
ERL (error logger task), ERL A.1 Event flags, EXE 2.2, INT 3.3 
Errlog (error logger), E in mo operations, JOP 2.8 
‘ vents, 
pelea ae significant, DRV 1.5, EXE 1.2, INT 3.3 
messages, ERL 5.1 Executive, 
running, ERL 3.1 control, INT 3.2 


error codes, EXE B 


BTEOP Oe suey erate features for error logging, ERL 2.1 


executive features of, ERL 2.1 services and I/O drivers, WRT 2.4, 6 
functions of, BRL 1.2 Executive Debugging Tool, see XDT 
information from, ERL 1.2 Executive directives, see Directives 
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F 


FCS, INT 6.3, IOP 1 
library system generation options, JOP K 
resident library, 
building 4K, GEN G 
spooling from user-written tasks with, 
UTL 6.5 
FDB (File Descriptor Block), JOP 1.9, 2.2, A 
offsets, JOP 2.3 
File access, 
methods of, JOP 1.1 
optimizing, JOP 2.5 
File control routines, 
ASCII-to-binary UIC conversion, JOP 4.6 
default directory-string, JOP 4.2 
default file-protection word, JOP 4.4 
default UIC, JOP 4.3 
device control, JOP 4.16 
directory entry, JOP 4.8 
file deletion, JOP 4.15 
file extension, JOP 4.13 
filename block, JOP 4.7, 4.9 
file owner word, JOP 4.5 
file pointer, JOP 4.10 
file truncation, JOP 4.14 
queue /O function, JOP 4,11 
rename file, JOP 4.12 


File Control Services, see FCS 
File Descriptor Block, see FDB 
File despooling, UTL 6.1, C 
File directory, see UFD 
File dumping, UTL 15 
File Dump Utility, see DMP 
File-header block format, JOP F 
File labels, DSC, UTL 11.5 
File manipulation, INT 6.2 
Filename block, JOP B 
File ownership, INT 6.2, MCR 3.1 
File protection, INT 6.2 
access type, MCR 3.1 
assigning access rights, MCR 3.1 
user groups, MCR 3.1 
with PIP, UTL 4.2 
Files, 
copying, BEG 4.2, UTL 4.2 
creating, BEG 2.1 
with EDI, UTL 3 
with EDT, UTL 2 
with SLP, UTL 17 
correction, 
PAT, UTL 18.2 


Files (Cont.), 
deleting, BEG 4.2 
despooling, UTL 6.1, 6.4, 7,C 
device name, BEG 3.1 
displaying, BEG 4.2 
editing, BEG 2.1 
with EDI, UTL 3 
with EDT, UTL 2 
with SLP, UTL 17 
indirect command, 
MCR, MCR 5 
library, UTL 14.5 
listing, in queue, BEG 4.3 
manipulating, INT 6.2 
merging, UTL 4.2 
printing, BEG 4.3, UTL 4.2, 6,7 
purging, BEG 4.2, UTL 4.2 
renaming, BEG 4.2, UTL 4.2 
spooling, UTL 4.2, 6.1, 6.2, 7,C 
task image, structure of, TKB B 
UFDs for, BEG 3.2 
validating (verifying) contents of, 
with PAT, UTE 18.2 
with SLP, UTL 17.1, 17.5 
Files-11, 
copying, files with PIP, UTL 4.2 
directories (UF Ds) for files, INT 6.2, 
MCR 3.1 
ownership of files, INT 6.2, MCR 3.1 
protection for files, INT 6.2, MCR 3.1, 
UTL 4.2 
access types, MCR 3.1 
assigning access rights, MCR 3.1 
user groups, MCR 3.1 
File specifications, INT 6.2 
creating, within user program, [OP 2.4 
dataset descriptor in, JOP 2.4 
default filename block in, JOP 2.4 
dynamic processing of, JOP 2.4 
for utilities, 
defaults for, UTL 1.1 
format of, UTL 1.1 
MCR, MCR 3.2 
TKB, TKB 1.7 
File specifiers, 
MCR, MCR 3.2 
File spooling, UTL 6.1, 6.2, 7 
File Storage Region, see FSR 
File-structured devices, 
data formats for, JOP 1.2 
File structures, 
disk and DECtape (Files-11), JOP 5.1 
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File structures (Cont.), 
in magnetic tape file processing, JOP 5.2 
verifying, with VFY, UTL 13 
File Structure Verification Utility, see VFY 
File system, 
Files-11, see Files-11 
RSX-11M, INT 6.1 
File Transfer Program, see FLX 
File transfers, 
with BRU, UTL 10.4 
with DSC, UTL 11.8 
with FLX, UTL 5 
with PIP, UTL 4.2 
File types, 
MCR standard, MCR 3.2 
FLX (File Transfer Program), UTL 5 
file transfers, 
command line for, UTL 5.1 
volumes, 
transferring files between, UTL 5.2 


FMT (Disk Volume Formatter), UTL 8 
Fork list, 
and I/O drivers, WRT 2.3 
Format, 
file header block, JOP F 
index file, JOP E 
QIO macro format, DRV 1.5 
TKB input data, TKB A 
Formats, 
CMP output file, UTL 16.2 
data, 
for file-structured devices, JOP 1.2 
Formatting, 
output, routines for, SLR 6 
volumes, 
with FLX, UTL 5 
with FMT, UTL 8 
FORTRAN IV, INT 5.2 
compiling, source file, BEG 2.2 
requesting a nonresident compiler, BEG 2.2 
sample program, BEG A 
FORTRAN IV-PLUS, INT 5.2 
FSR (File Storage Region), JOP 1.1 
initializing, [OP 2.6 
size of, JOP 2.7 


G 


Generating an RSX-11M system, see System 
generation 

Global symbols, TKB 2.1, 4.2 

Graphics display driver, DRV 20 


H 


HELLO command, BEG 1.2, MCR 2.3, 4.5 
HELP command, BEG 1.2, MCR 4.5 


I 


Immediate addressing mode, MAC 5.9 
Index addressing mode, MAC 5.7 
Index deferred addressing mode, MAC 5.8 
Index file, 
format, JOP E 
bit map in, JOP E.3 
bootstrap block in, JOP E.1 
home block in, JOP E.2 
predefined file header blocks in, JOP E.4 
Indirect command files, 
MCR, INT 4.1, MCR 5.1 
AT. (indirect file processor), MCR 5.2 
default file type for, MCR 5.1 
example of, MCR 5.8 
initiating, MCR 5.1 
multilevel, MCR 5.5 
switches, MCR 5.4 
symbols, MCR 5.3 
task, MCR 5.1, TKB 1.5 
with utilities, UTL 1.4 
Industrical control subsystems drivers, 
DRV 18 
Initializing volumes, 
with FLX, UTL 5.2 
Install-run-remove tasks, MCR 4.2 
Interrupts, 
report on unexpected, ERL 4.2 
Invoking, 
RSX-11 utilities, UTL 1.1 
Lo, 
logical, DRV 1.2 
physical, DRV 1.2 
RSX-11M, DRV 1.1 
virtual, DRV 1.2 
I/O completion, DRV 1.9 
I/O data structures, WRT 2.3 
interrelationships, WRT 2.7 
I/O drivers, see Drivers 
I/O executive services, WRT 2.4 
I/O exerciser, see JOX 
I/O function codes, DRV B.38 
I/O functions, 
standard, DRV 1.8 
summary of, DRV A 
I/O operations, 
block, JOP 1.4 
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I/O operations (Cont.), 
coordinating, JOP 2.8 
AST service routine, JOP 2.8 
event flags, [OP 2.8 
I/O status block, JOP 2.8 
physical, INT 6.4 
record, JOP 1.5 
task, INT 6.3 
I/O packet, 
and I/O drivers, WRT 2.3, 4.1 
I/O philosophy, WRT 2.1 
I/O programming standards, WRT 2.5 
I/O queue, 
and I/O drivers, WRT 2.3 
I/O request, 
flow of, WRT 2.6 
issuing, DRV 1.5 
I/O status codes, DRV B.1 
I/O structure, WRT 2.2 
IOX (I/O exerciser), GEN E 


K 


K-series peripheral support routines drivers, 
DRV 22 


L 


Laboratory peripheral accelerator driver, 
DRV 21 
Laboratory peripheral systems driver, DRV 16 
Languages, 
BASIC-11, INT 5.2 
BASIC-PLUS-2, INT 5.2 
COBOL, INT 5.2 
CORAL-66, INT 5.2 
FORTRAN IV, INT 5.2 
FORTRAN IV-PLUS, INT 5.2 
supported, INT 2.2 
LBR (Librarian Utility Program), UTL 14 
Library, 
files, 
format of, UTL 14.5 
system, routines, see System library rou- 
tines 
Line printer driver, DRV 10 
Line Text Editor, see EDI 
Listing files, 
creating, BEG 2.2 
in queue, BEG 4.3 
with FLX, UTL 5.2 
with PIP, UTL 4.2 


Locations, manipulating, 
in a task image file, UTL 19.5, 19.6 
Logging off a terminal, MCR 2.3 
Logging on a terminal, MCR 2.3 
Logical address space, EXE 3.1 
extended, INT 3.3 
Logical I/O, DRV 1.2 
Logical unit number, see LUN 
Logical units, DRV 1.4 
LPP (Despool Prototype Task), 
as component of Queue Manager, UTL 7 
LUN (Logical Unit Number), DRV 1.4, 1.7 


M 


Macro 
QIO, format, DRV 1.5 
MACRO-11, INT 5.2 

addressing, 
branch instruction, MAC 5.14 

addressing modes, 
absolute, MAC 5.10 
autodecrement, MAC 5.5 
autodecrement deferred, MAC 5.6 
autoincrement, MAC 5.3 
autoincrement deferred, MAC 5.4 
immediate, MAC 5.9 
index, MAC 5.7 
index deferred, MAC 5.8 
register, MAC 5.1 
register deferred, MAC 5.2 
relative, MAC 5.11 
relative deferred, MAC 5.12 
summary of, MAC 5.13 

assembly and cross-reference listing, 
sample of, MAC I 

character set, MAC 3.1 

coding standard, 
sample of, MAC E 

command line format, MAC 8.1 

direct assignment statements for, MAC 3.3 

directives, 
conditional assembly, MAC 6.10 
data storage, MAC 6.3 
function, MAC 6.2 
listing control, MAC 6.1 
location counter control, MAC 6.5 
macro, MAC 7 
program boundaries, MAC 6.7 
program sectioning, MAC 6.8 
summary of, MAC B 
symbol control, MAC 6.9 
terminating, MAC 6.6 
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MACRO-11 (Cont.), 
error messages, MAC 8.4 
summary of diagnostic, MAC D 
expressions, MAC 3.9 
file specification format, MAC 8.3 
file specification switches, MAC 8.1 
numbers, MAC 3.7 
operating procedures, MAC 8 
overview of, MAC 1.1 
Permanent Symbol Table (PST), MAC C 
position-independent code, 
writing, MAC G 
radix and numeric control facilities, MAC 6.4 
relocation and linking, MAC 4 
source programs, MAC 2.2, 2.3 
programming standards and conventions 
for, MAC 2.1 
symbols, MAC 3.2 
local, MAC 3.5 
register, MAC 3.4 
terms, MAC 3.8 
trap instructions, MAC 5.15 
virtual memory, 
allocating, MAC F 
Macro calls, 
file-processing, JOP 3.1-18 
Macros, 
arguments for, MAC 7.3 
calling, MAC 7.2 
defining, MAC 7.1 
1/O-related, DRV 1.7 
Magnetic tapes, 
ANSI standard, JOP G 
driver for, DRV 8 
Maintenance, 
system, features of, INT 4.4 
Mapped systems, INT 3.1 
task relocation on, TKB 2.4 
TKB addressing on, TKB 2.2 
Mapping, 
addresses, EXE 3.1 
MCR, 
command line, MCR 3.2 
commands, BEG 1.2 
description of format and syntax, MCR 4.4 
format for, MCR 4.1 
issuing, MCR 4.1 
line terminators for, MCR 4.1 
nonprivileged, MCR 4.5 
parameters for, MCR 4.1 
privileged, MCR 4.6 
summary of, MCR 4.3 
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MCR interface, INT 4.1, MCR 4.2 
command references to active tasks, 
MCR 4.2 
comments, MCR 4.2 
keywords, MCR 4.2 
Memory, 
organization of, INT 3.1 
parity error reports, EARL 4.2 
Memory dumps, TKB 8.1, 8.2 
Memory management, 
directives, EXE 3, 6.1 
dynamic, routines, SLR 7 
virtual, routines, SLR 8 
Merging files, UTL 4.2 
Message-oriented communication driver, 
DRV 12 
Messages, see Error Messages 
Mode, 
supervisor, 
addressing in, EXE 3.2 
Modes, 
for reading logical records, JOP 3.9, 3.10, 
3.11 
for writing logical records, JOP 3.12, 3.13, 
3.14 
MACRO-11 addressing, MAC 5 
Monitor Console Routine, see MCR 
Multicontroller I/O drivers, WRT 4.2 
Multiprogramming, MCR 1.3 
applications, MCR 3 


N 


Networks, INT 2.3 
Null device, MCR 2.2 
driver, DRV 19 


O 


Object Module Patch Utility, see PAT 
Object modules, 
creating, BEG 2.2 
linking with TKB, TKB 2.1 
updating, with PAT, UTL 18.2 
ODT (On-Line Debugging Tool), 
linking and initiating, ODT 4.3 
relationship to ZAP, UTL 19 
Offsets, 
FDB, JOP 2.3 
On-Line Debugging Tool, see ODT 
Operating procedures, 
error logging, ERL 3 


INDEX 


Operating procedures (Cont.), 
MACRO-11, MAC 8 
ODT, ODT 4 
Operators, 
SLP, UTL 17.3 
ZAP arithmetic, UTL 19.4 
Output, 
formatting routines, SLR 6 
Overlay, TKB, 
building an, TKB 4.7 
data structures, TKB 4.3 
descriptor language, TKB 4.4 
summary of, TKB 4.5 
error handling, TKB 5.3 
loading methods, TKB 5.1, 5.2 
programs, TKB 4.6 
structures, TKB 4.1 
tree, TKB 4.2, 4.5 


P 


Paper tape reader/punch driver, DRV 17 
Parent/offspring tasking, EXE 4.1, 4.2 
Parity error reports, ERL 4.2 
Parsing a UFD command line, 
example of, IOP 7.6 
Partitions, MCR 1.2 
PAT (Object Module Patch Utility), UTL 18 
Task Builder and, 
adding a subroutine to a module with, 
UTL 18.2 
overlaying lines in module with, UTL 18.2 
updating (patching) object modules with, 
UTL 18.2 
Patching, 
object modules (relocatable), with PAT, 
UTL 18.2 
task image files, with ZAP, UTL 19.5 
PCL11 parallel communications link driver, 
DRV 18 
Peripheral Interchange Program, see PIP 
Permanent Symbol Table, see PST 
Physical I/O, DRV 1.2 
operations, INT 6.4 
PIP (Peripheral Interchange Program), BEG 
4.1, INT 6.2, UTL 4 
command functions, UTL 4.2 
copying Files-11 files with, UTL 4.2 
Position-independent code, 
writing, MAC G 
Post mortem dumps, INT 5.5, TKB 8.1 
Powerfail recovery, 
for DECtape and disks, DRV 1.11 


Power failure restart, INT 4.4 
Preservation Utility, see PRESRV 
PRESRYV (Preservation Utility), UTL 12 
operating procedures, UTL 12.2 
PRI and QUE (Print and Queue Manager), 
despooling files with, UTL 6.1 
Print command, UTL 6.1-3 
format, UTL 6.2 
Queue Manager, 
command format, UTL 6.4 
commands, 
nonprivileged user, UTL 6.4 
privileged user, UTL 7.3 
serial despooler with, UTL 6.1 
spooling, 
files with, UTL 6.1 
output from user-written tasks with, 
UTL 6.5 
PRINT command, 
format, UTL 6.2 
description of, UTL 6.3 
spooling output from user-written tasks 
with, UTL 6.5 
Printing files, BEG 4.3 
Print jobs, UTL 6.1 
attributes of, UTL 6.1 
identification, UTL 6.4 
queued by user tasks, UTL 6.5 
queue entries for, UTL 7 
Processor Status Word, see PSW 
Program development, INT 2.2 
cross-reference listing in, 
generating, DEV 3.5, 4.3 
debugging in, INT 5.5, DEV 5 
dumps in, INT 5.5, DEV 5.2, 5.3 
editing utilities for, INT 5.1 
environment, DEV 1 
DIGITAL-supplied system software, 
DEV 1.2 
hardware, DE'V 1.3 
software tools, DEV 1.1 
errors, 
assembly, DEV 3.1 
task building, DEV 4.4 
Fortran IV, procedures, DEV 7 


languages for, INT 5.2 
supported, INT 2.2 


process, DEV 1.4 


program libraries in, 
macro source, DEV 6.1 
object module, DEV 6.2 


program modules in, DEV 3 
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Program development (Cont.), 
source files in, 
creating from a skeleton file, DEV 2.2 
diagnostics, performing, DEV 3.1 
editing, DEV 2.3 
MACRO-11, creating, DEV 2 
task building in, INT 5.3, DEV 4, TKB 3.1 
Programming languages, see Languages 
Program sections, TKB 2.1, 4.2 
virtual, TKB 3.4 
Prompts, 
MCR input, MCR 2.1 
Protecting files, see File protection 
PSE (error logging pre-formatter), FAL 
2.2, 3.2 
PSW (Processor Status Word), ODT A 
Purging files, BEG 4.2, UTL 4.2 


Q 


QIO macro format, DRV 1.5 
Queue Manager, BEG 4.3, INT 6.2 
RSX-11M V3.2, UTL 6,7, GEN D 
command format, UTL 6.3, 7.4 
commands, 
nonprivileged, UTL 6.4 
privileged, UTL 7.3 
components of, UTL 7 
installing, UTL 7.1 
reference example, UTL 7.2 


R 


RDB (Region Definition Block), EXE 3.5 
Record I/O operations, JOP 1.5 
Record Management Services, see RMS 
Region Definition Block, see RDB 
Regions, EXE 3.3 

dynamic, in TKB, TKB 3.3 

shared, in TKB, TKB 3.1 

Register addressing mode, MAC 5.1 
Register deferred addressing mode, MAC 5.2 
Register handling routines, SLR 2 
Reject transitions, 

example of using, JOP 7.6 
Relative addressing mode, MAC 5.11 
Relative deferred addressing mode, MAC 5.2 
Renaming files, BEG 4.2 

with PIP, UT'L 4.2 
Reports, error logging, see Error logging, 

reports , 

Restarting system, 

after power failure, INT 4.4 


Return codes, DRV 1.10 
RM Demo, GEN B 
RMS (Record Management Services), [NT 6.3 
Round robin scheduling, INT 3.2 
Routines, 
file control, see File control routines 
system library, see System library routines 
RSX-11M, 
applications of, 
multiprogramming, INT 3 
real-time, INT 2.1, 3 
devices, DRV 1.3 
file system, INT 6.1 
introduction to, INT 1.1 
system generation, see System generation 
RSX-11S, 
introduction to, INT 1.2 


S 


SCB (Status Control Block), 
and I/O drivers, WRT 2.3, 4.1 
Serial Despooler Task, UTL 6.1, C 
Shared Peripheral Operations On-Line, see 
Spool 
Shutting down system, MCR 2.4 
SHUTUP program, MCR 2.4 
Significant events, DRV 1.5, EXE 2.1, INT 3.2 
SLP (Source Language Input Program), 
UTL 17 
editing source files with, UTL 17.3 
processing, UTL 17.2 
Snapshot dumps, JNT 5.5, TKB 8.2 
Source files, 
creating with SLP, UTL 17.3 
updating with SLP, UTL 17.3 
Source Language Input Program, see SLP 
Spool (Shared Peripherals Operation On-Line), 
UTL 6.1 
Spooling, 
from user-written tasks, UTL 6.5 
with PIP, UTL 4.2 
with PRI and QUE, UTL 6.1 
with PRINT$ macro call, JOP 7.6 
SST (Synchronous System Trap), DRV 1.5, 
EXE 2.3, INT 3.3 
Status Control Block, see SCB 
Stop-bit synchronization, EXE 2.4 
Subexpressions, 
example of using, JOP 7.6 
Subpartitions, INT 3.1, MCR 1.2 
Supervisor mode, 
addressing in, EXE 3.2 
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Swapping, INT 3.2 
Switches, 
BAD, UTL 9.2, 9.5 
CDA, CDA 2.1, 2.2 
CMP, UTL 16.1 
DMP, UTL 15.3 
DSC, UTL 11.5, 11.7 
FLX, UTL 5.2 
FMT, UTL 8.4 
for utilities, summary of, UTL A 
LBR, UTL 14.4, 14.6 
MCR, MCR 5.4 
ODT, ODT 4.2 
PAT, UTL 18.1 
PIP, UTL 4.1, 4.2 
PRESRV, UTL 12.3 
Print command, UTL 6.3 
Queue Manager, UTL 6.3 
SLP, UTL 17.4 
TKB, TKB 6.1 
modifying defaults for, TAB D.2 
ZAP, UTL 19.2 
SYE (error logging report generator), EARL 3.3 
Symbol definition file, TKB 3.1 
Symbols, 
global, TKB 2.1, 4.2 
indirect command file, MCR 5.3 
reserved, TKB C 
substituting values for, INT 4.1 
Synchronous System Trap, see SST 
System, 
host, for TKB, TKB 7 
restarting, after power failure, INT 4.4 
shutting down, MCR 2.4 
target, for TKB, TKB 7 
System conventions, GEN F 
System directives, see Directives, system 
System generation, RSX-11M V3.2 
getting started, GEN 5 
installation verification, GEN 10 
system conventions, GEN F 
VMR, GEN 8 
System library routines, 
arithmetic routines, SLR 3.1, 3.2 
dynamic memory management routines, 
SLR 7.1-4 
input data conversion routines, SER 4.1-3 
output data conversion routines, SLA 5.1-4 
output formatting routines, SLR 6.1-3 
register handling routines, SLR 2.1-4 
virtual memory management routines, 
SLR 8.1-5 


System maintenance, 
features of, INT 4.4 
System traps, INT 3.3 
asynchronous (ASTs), DRV 1.5, EXE 2.3, 
INT 3.3 
synchronous (SSTs), DRV 1.5, EXE 2.3, 
INT 3.3 


T 


Table-driven parser, see TPARS 
Tape devices, 
multivolume operations with BRU, 
UTL 10.5 
Tapes, 
DECtape, see DECtape 
magnetic, see Magnetic tapes 
Task, 
interaction with error logging, FRL 2.2 
I/O operation, INT 6.3 
Task Builder, see also TKB 
use of, with PAT, UTL 18.2 
Task dumps, 
post mortem, INT’ 5.5, TKB 8.1 
snapshot, INT 5.5, TKB 8.2 
Task image, 
building, BEG 2.3 
file, structure of, TKB B 
memory allocation (map) file, BEG 2.3 
options, BEG 2.3 
running a, BEG 2.4 
switches, BEG 2.3 
Task/Image File Patch Program, see ZAP 
Task names, 
convention for, MCR 4.2 
references to in MCR, MCR 5.7 
Tasks, MCR 1.1 
building, INT 5.3, TKB 3.1 
checkpointing, INT 3.2 
creating, MCR 1.4 
debugging, INT 5.5 
executing, INT 5.4, MCR 1.4 
external scheduling for, INT 4.1 
installing, MCR 1.4 
install-run-remove, MCR 4.2 
linking, TKB 3.1 
MCR command interface and, MCR 4.2 
multiuser, TKB 3.2 
naming convention for, MCR 4.2 
priority of, INT 3.2 
privileged, EXE 3.6, TKB 3.5 
scheduling, 
external, INT 4.1 
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Tasks, scheduling (Cont.), 

round robin, [NT 3.2 

swapping, INT 3.2 
state of, INT 3.2 
user-written, spooling from, UTL 6.5 
Terminals, 
attached, INT 4.2, MCR 2.1 
characteristics of, MCR 2.1 


control characters on, BEG 1.1, MCR 2.1 


drivers for, 
full-duplex, DRV 2 
half-duplex, DRV 3 
virtual, DRV 4 
function keys on, BEG 1.1 
input prompts for, MCR 2.1 
keyboard on, BEG 1.1 
logging off, MCR 2.3 
logging on, MCR 2.3 
privilege for, MCR 2.1 
slave, INT 4.2, MCR 2.1 
special character keys on, MCR 2.1 
unattached, MCR 2.1 


TKB, see also Task Builder, 
assigning addresses, 
on mapped systems, TKB 2.2 
on unmapped systems, TKB 2.2 
building and linking with, TKB 3.1 
command line, TKB 1.1 
data structures, 
building system, TKB 2.3 
overlay, TKB 4.3 
fast, TKB E 
functions, TKB 2 
global symbols, 
resolving, TKB 2.1, 4.2 
host system for, TKB 7 
improving performance of, TKB D 
memory dumps, 
post mortem, TKB 8.1 
snapshot, TKB 8.2 
program sections, 
allocation of, TKB 2.1, 4.2 
virtual, TKB 3.4 
object modules, 
linking, TKB 2.1 
overlay, 
building an, TKB 4.7 
data structures, TKB 4.3 
descriptor language, TKB 4.4 
summary of, TKB 4.8 
error handling, TKB 5.3 
loading methods, TKB 5.1, 5.2 
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TKB, overlay (Cont.), 
programs, TKB 4.6 
structures, TKB 4.1 
tree, TKB 4.2 
multiple-tree structures, TKB 4.5 
reserved symbols, TKB C 
slow, TKB D.3 
symbol definition file, TKB 3.1 
target system for, TKB 7 
task image file structure, TKB B 
task relocation, TKB 2.4 
tasks, 
multiuser, TKB 3.2 
privileged, TKB 3.5 
TPARS 
parser program using, 
how to generate, JOP 7.5 
source programs and, JOP 7.1 
Transferring files, 
with BRU, UTL 10.4 
with DSC, UTL 11.8 
with FLX, UTL 5 
with PIP, UTL 4.2 
Traps, 
reports on unexpected, BERL 4.2 
systems, INT 3.3 
asynchronous (ASTs), DRV 1.5, EXE 2.3 
synchronous (SSTs), DRV 1.5, EXE 2.3 


U 


UCB (Unit Control Block), 
and I/O drivers, WRT 2.3, 4.1 
UFD (User File Directory), BEG 3.2 
creating, with PIP, UTL 4.2 
in Files-11 file system, INT 6.2, MCR 3.1 
UIC (User Identification Code), MCR 3.2 
UMD (User-Mode Diagnostics), see Diagnos- 
tics, user mode 
Unibus switch driver, DRV 23 
Unit Control Block, see UCB 
Universal digital controller driver, DRV 15 
Unmapped systems, INT 3.1 
User File Directory, see UFD 
User Identification Code, see UIC 
User-Mode Diagnostics, see Diagnostics, 
user-mode 
User written drivers, see Drivers, I/O, 
user-written 
Utilities, 
command line format for, UTL 1.1 
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Utilities (Cont.), 
editing, 
EDI, UTL 3 
EDT, UTL 2 
file manipulation, 
FLX, UTL 5 
PIP, UTL 4 
file specification format for, UTL 1.1 
file spooling, 
PRI and QUE, UTL 6 
Queue Manager, UTL 7 
indirect command files and, UTL 1.4 
invoking, UTL 1.4 
list of, UTL 1.1 
program maintenance, 
CMP, UTL 16 
PAT, UTL 18 
SLP, UTL 17 
ZAP, UTL 19 
programming, 
DMP, UTL 15 
LBR, UTL 14 
volume maintenance, 
BAD, UTL 9 
BRU, UTL 10 
DSC, UTL 11 
FMT, UTL 8 
PRESRV, UTL 12 
VFY, UTL 13 


Vv 


Verifying, 
contents of a task image file with ZAP, 
UTL 19.6 
file structures with VFY, UTL 13 
VFY (File Structure Verification Utility), 
UTL 18 
Virtual address space, EXE 3.1 


Virtual 1/0, DRV 1.2 
Virtual Monitor Console Routine, see VMR 
VMR (Virtual Monitor Console Routine), 
GEN 8 
Volumes, 
backing up, with BRU, UTL 10.4 
deleting files from, with FLX, UTL 5.2 
directory listings of, with FLX, UTL 5.2 
formatting, 
with FLX, UTL 5.2 
with FMT, UTL 8.3 
initializing, with FLX, UTL 5.2 
preserving, with PRESRV, UTL 12 
transferring files between, with FLX, 
UTL 5.2 


WwW 


WDB (Window Definition Block), 
data structure, EXE 3.5 
Wildcards (asterisk), 
convention as file specifier, MCR 3.2 
in PIP file specifications, UTL 4.1 
Window Definition Block, see WDB 


xX 


XDT (Executive Debugging Tool), 
and I/O drivers, WRT 3.4 


Z 


ZAP (Task/Image File Patch Program), 
UTL 19 
addressing locations in a task image with, 
UTL 19.3 
changing contents of a location with, 
UTL 19.5 
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READER’S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company’s discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 


Did you find this manual understandable, usable, and well-organized? Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of user/reader that you most nearly represent. 


[ Assembly language programmer 
Ol =- Hiigher-level language programmer 
O Occasional programmer (experienced) 
O —_—User with little programming experience 
O = Student programmer 
Oh Other (please specify) 
Name Date 
Organization _ 
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City State LTT Zip Code 
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